Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Changes to the Extension API #23

Closed
melisgl opened this issue Jun 16, 2023 · 3 comments
Closed

Changes to the Extension API #23

melisgl opened this issue Jun 16, 2023 · 3 comments
Labels

Comments

@melisgl
Copy link
Owner

melisgl commented Jun 16, 2023

I'm going to overhaul the PAX::@EXTENSION-API because its semantics are rather baroque. If your code will be broken by the following proposed changes, I'd like to hear about it.

The changes will not affect normal use (e.g. DEFSECTION, navigating, documenting, browsing, transcribing), or the obscure DEFINE-SYMBOL-LOCATIVE-TYPE, DEFINE-DEFINER-FOR-SYMBOL-LOCATIVE-TYPE, but the following changes are planned:

  • REFERENCE will be renamed to something shorter.
  • MAKE-REFERENCE may go away.
  • The contract and maybe the name of CANONICAL-REFERENCE will change.
  • The LOCATE-AND-* stuff will be removed.
  • The contracts and names of LOCATE-OBJECT, DOCUMENT-OBJECT, DOCSTRING may change.

In summary, code that works with REFERENCES or defines a locative type (except by DEFINE-SYMBOL-LOCATIVE-TYPE) will break.

@melisgl
Copy link
Owner Author

melisgl commented Jun 25, 2023

This is a work in progress. The changes are going to be more extensive than described above. Dealing with references (to definitions) is going to be factored out into its own library similar to https://github.com/Shinmera/definitions, but which doesn't quite serve the needs of PAX.

@melisgl
Copy link
Owner Author

melisgl commented Jul 6, 2023

Here is the pull request: #29.
I'm going to give it a day or two before merging it and check that I'm not breaking anything in Quicklisp.
In the meantime, I'd appreciate any comments on the DRef api (see the readme):
https://github.com/melisgl/mgl-pax/tree/dref/dref

@melisgl
Copy link
Owner Author

melisgl commented Jul 26, 2023

This is committed as 171e93f.

@melisgl melisgl closed this as completed Jul 26, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant