diff --git a/src/contrib/asdf/doc/asdf.html b/src/contrib/asdf/doc/asdf.html index eb82eeb63d9e16cc5a8dac4039faafb03d29e171..8e85b2f6d8339af8d217b0c3d4679b3222b75641 100644 --- a/src/contrib/asdf/doc/asdf.html +++ b/src/contrib/asdf/doc/asdf.html @@ -31,7 +31,7 @@ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --> -<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ --> <head> <title>ASDF Manual</title> @@ -276,7 +276,7 @@ ul.no-bullet {list-style: none} <a name="Top"></a> <a name="ASDF_003a-Another-System-Definition-Facility"></a> <h1 class="top">ASDF: Another System Definition Facility</h1> -<p>Manual for Version 3.2.0 +<p>Manual for Version 3.2.1 </p> <p>This manual describes ASDF, a system definition facility @@ -3404,8 +3404,13 @@ otherwise it continues. If multiple systems are found, the consequences are unspecified: the search may succeed with any of the found systems, or an error may be raised. -ASDF currently returns the first system found, -XCVB currently raised an error. +ASDF 3.2.1 or later returns the pathname whose normalized directory component +has the shortest length (as a list), and breaks ties by choosing the system +with the smallest <code>unix-namestring</code> when compared with <code>string<</code>. +Earlier versions of ASDF return ASDF return the first system found, +which is implementation-dependent, and may or may not be the pathname +with the smallest <code>unix-namestring</code> when compared with <code>string<</code>. +XCVB raises an error. If none is found, the search continues. </p> <p>Exclude statements specify patterns of subdirectories diff --git a/src/contrib/asdf/doc/asdf.info b/src/contrib/asdf/doc/asdf.info index 115c20a48902fb7047dbd762c71a752bfc449192..c881a7017082c1234a61d6f22bc377ad2baf1855 100644 --- a/src/contrib/asdf/doc/asdf.info +++ b/src/contrib/asdf/doc/asdf.info @@ -1,4 +1,4 @@ -This is asdf.info, produced by makeinfo version 6.1 from asdf.texinfo. +This is asdf.info, produced by makeinfo version 6.3 from asdf.texinfo. This manual describes ASDF, a system definition facility for Common Lisp programs and libraries. @@ -43,7 +43,7 @@ File: asdf.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) ASDF: Another System Definition Facility **************************************** -Manual for Version 3.2.0 +Manual for Version 3.2.1 This manual describes ASDF, a system definition facility for Common Lisp programs and libraries. @@ -3097,8 +3097,14 @@ succeeds, otherwise it continues. When looking in a tree, if one system is found, the search succeeds. If multiple systems are found, the consequences are unspecified: the search may succeed with any of the found systems, or an error may be -raised. ASDF currently returns the first system found, XCVB currently -raised an error. If none is found, the search continues. +raised. ASDF 3.2.1 or later returns the pathname whose normalized +directory component has the shortest length (as a list), and breaks ties +by choosing the system with the smallest 'unix-namestring' when compared +with 'string<'. Earlier versions of ASDF return ASDF return the first +system found, which is implementation-dependent, and may or may not be +the pathname with the smallest 'unix-namestring' when compared with +'string<'. XCVB raises an error. If none is found, the search +continues. Exclude statements specify patterns of subdirectories the systems from which to ignore. Typically you don't want to use copies of files @@ -5862,77 +5868,77 @@ Node: Configuration Directories131731 Node: The here directive133558 Node: Shell-friendly syntax for configuration135451 Node: Search Algorithm136468 -Node: Caching Results137969 -Node: Configuration API141213 -Node: Introspection143252 -Node: *source-registry-parameter* variable143516 -Node: Information about system dependencies144085 -Node: Status145001 -Node: Rejected ideas145456 -Node: TODO147837 -Node: Credits for the source-registry148022 -Node: Controlling where ASDF saves compiled files148557 -Ref: Controlling where ASDF saves compiled files-Footnote-1149969 -Node: Output Configurations150013 -Ref: Output Configurations-Footnote-1152874 -Node: Output Backward Compatibility152940 -Node: Output Configuration DSL155666 -Node: Output Configuration Directories161121 -Node: Output Shell-friendly syntax for configuration162678 -Node: Semantics of Output Translations164197 -Node: Output Caching Results165766 -Node: Output location API166246 -Node: Credits for output translations168668 -Node: Error handling169188 -Node: Miscellaneous additional functionality170029 -Node: Controlling file compilation170501 -Node: Controlling source file character encoding173767 -Node: Miscellaneous Functions180584 -Ref: system-relative-pathname180881 -Ref: Miscellaneous Functions-Footnote-1187328 -Node: Some Utility Functions187439 -Node: Getting the latest version198217 -Node: FAQ199162 -Node: Where do I report a bug?199557 -Node: Mailing list199922 -Node: What has changed between ASDF 1 ASDF 2 and ASDF 3?200257 -Node: What are ASDF 1 2 3?202431 -Node: How do I detect the ASDF version?203472 -Node: ASDF can portably name files in subdirectories205779 -Node: Output translations207329 -Node: Source Registry Configuration208356 -Node: Usual operations are made easier to the user209983 -Node: Many bugs have been fixed210569 -Node: ASDF itself is versioned212401 -Node: ASDF can be upgraded213276 -Node: Decoupled release cycle214428 -Node: Pitfalls of the transition to ASDF 2215357 -Node: Pitfalls of the upgrade to ASDF 3219627 -Ref: Pitfalls of the upgrade to ASDF 3-Footnote-1223996 -Node: What happened to the bundle operations224166 -Node: Issues with installing the proper version of ASDF225331 -Node: My Common Lisp implementation comes with an outdated version of ASDF. What to do?225802 -Node: I'm a Common Lisp implementation vendor. When and how should I upgrade ASDF?226735 -Node: Issues with configuring ASDF230618 -Node: How can I customize where fasl files are stored?230993 -Node: How can I wholly disable the compiler output cache?232086 -Node: Issues with using and extending ASDF to define systems233465 -Node: How can I cater for unit-testing in my system?234262 -Node: How can I cater for documentation generation in my system?235150 -Node: How can I maintain non-Lisp (e.g. C) source files?235671 -Ref: report-bugs236103 -Node: I want to put my module's files at the top level. How do I do this?236103 -Node: How do I create a system definition where all the source files have a .cl extension?239253 -Node: How do I mark a source file to be loaded only and not compiled?241226 -Node: How do I work with readtables?242222 -Node: How can I capture ASDF's output?245949 -Node: LOAD-PATHNAME has a weird value246420 -Node: ASDF development FAQs247906 -Node: How do I run the tests interactively in a REPL?248145 -Node: Ongoing Work250011 -Node: Bibliography250290 -Node: Concept Index253761 -Node: Function and Class Index260620 -Node: Variable Index272394 +Node: Caching Results138338 +Node: Configuration API141582 +Node: Introspection143621 +Node: *source-registry-parameter* variable143885 +Node: Information about system dependencies144454 +Node: Status145370 +Node: Rejected ideas145825 +Node: TODO148206 +Node: Credits for the source-registry148391 +Node: Controlling where ASDF saves compiled files148926 +Ref: Controlling where ASDF saves compiled files-Footnote-1150338 +Node: Output Configurations150382 +Ref: Output Configurations-Footnote-1153243 +Node: Output Backward Compatibility153309 +Node: Output Configuration DSL156035 +Node: Output Configuration Directories161490 +Node: Output Shell-friendly syntax for configuration163047 +Node: Semantics of Output Translations164566 +Node: Output Caching Results166135 +Node: Output location API166615 +Node: Credits for output translations169037 +Node: Error handling169557 +Node: Miscellaneous additional functionality170398 +Node: Controlling file compilation170870 +Node: Controlling source file character encoding174136 +Node: Miscellaneous Functions180953 +Ref: system-relative-pathname181250 +Ref: Miscellaneous Functions-Footnote-1187697 +Node: Some Utility Functions187808 +Node: Getting the latest version198586 +Node: FAQ199531 +Node: Where do I report a bug?199926 +Node: Mailing list200291 +Node: What has changed between ASDF 1 ASDF 2 and ASDF 3?200626 +Node: What are ASDF 1 2 3?202800 +Node: How do I detect the ASDF version?203841 +Node: ASDF can portably name files in subdirectories206148 +Node: Output translations207698 +Node: Source Registry Configuration208725 +Node: Usual operations are made easier to the user210352 +Node: Many bugs have been fixed210938 +Node: ASDF itself is versioned212770 +Node: ASDF can be upgraded213645 +Node: Decoupled release cycle214797 +Node: Pitfalls of the transition to ASDF 2215726 +Node: Pitfalls of the upgrade to ASDF 3219996 +Ref: Pitfalls of the upgrade to ASDF 3-Footnote-1224365 +Node: What happened to the bundle operations224535 +Node: Issues with installing the proper version of ASDF225700 +Node: My Common Lisp implementation comes with an outdated version of ASDF. What to do?226171 +Node: I'm a Common Lisp implementation vendor. When and how should I upgrade ASDF?227104 +Node: Issues with configuring ASDF230987 +Node: How can I customize where fasl files are stored?231362 +Node: How can I wholly disable the compiler output cache?232455 +Node: Issues with using and extending ASDF to define systems233834 +Node: How can I cater for unit-testing in my system?234631 +Node: How can I cater for documentation generation in my system?235519 +Node: How can I maintain non-Lisp (e.g. C) source files?236040 +Ref: report-bugs236472 +Node: I want to put my module's files at the top level. How do I do this?236472 +Node: How do I create a system definition where all the source files have a .cl extension?239622 +Node: How do I mark a source file to be loaded only and not compiled?241595 +Node: How do I work with readtables?242591 +Node: How can I capture ASDF's output?246318 +Node: LOAD-PATHNAME has a weird value246789 +Node: ASDF development FAQs248275 +Node: How do I run the tests interactively in a REPL?248514 +Node: Ongoing Work250380 +Node: Bibliography250659 +Node: Concept Index254130 +Node: Function and Class Index260989 +Node: Variable Index272763 End Tag Table diff --git a/src/contrib/asdf/doc/asdf.pdf b/src/contrib/asdf/doc/asdf.pdf index c440927bc0c12cb960ec4aded44d751b1cc3968b..d1a670e03df6fcae074400dd8685a95c7e14e793 100644 Binary files a/src/contrib/asdf/doc/asdf.pdf and b/src/contrib/asdf/doc/asdf.pdf differ