search

rabbibotton / clog

CLOG - The Common Lisp Omnificent GUI
Other
1.48k stars 101 forks source link

follow up on PAX changes #280

Closed melisgl closed 1 year ago

melisgl commented 1 year ago

In e0b7417, PAX was changed to not exporting SECTIONs and GLOSSARY-TERMs by default (see MGL-PAX:EXPORTABLE-REFERENCE-P). Following the example in the PAX documentation, this change makes the package CLOG export symbols naming SECTIONs to get the old behavior and make documentation generation work again.

Expanding on that, this may not be the right solution for CLOG. The default was changed because in most cases the names of sections are not part of the contract (i.e. they are subject to change) and exporting them can lead to package conflicts. Plus, with the @SECTION-NAME naming convention, one can list e.g. all PAX sections by typing "PAX::@" and pressing TAB in Slime.

rabbibotton commented 1 year ago

I will try and review next week. My time been consumed with flood damage this last month