From a96eeab541c6532d0e2e66789ca46f98a27a0547 Mon Sep 17 00:00:00 2001 From: "Robert P. Goldman" <rpgoldman@sift.net> Date: Sun, 19 Jul 2015 11:10:58 -0500 Subject: [PATCH] Add FAQ for mailing list, index entries. --- doc/asdf.texinfo | 35 ++++++++++++++++++++++++----------- 1 file changed, 24 insertions(+), 11 deletions(-) diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo index 4a3b4a2ab..823a96753 100644 --- a/doc/asdf.texinfo +++ b/doc/asdf.texinfo @@ -209,11 +209,13 @@ Miscellaneous additional functionality * Controlling file compilation:: * Controlling source file character encoding:: +* Miscellaneous Functions:: * Some Utility Functions:: FAQ * Where do I report a bug?:: +* Mailing list:: * What has changed between ASDF 1 ASDF 2 and ASDF 3?:: * Issues with installing the proper version of ASDF:: * Issues with configuring ASDF:: @@ -233,6 +235,7 @@ FAQ * ASDF can be upgraded:: * Decoupled release cycle:: * Pitfalls of the transition to ASDF 2:: +* Pitfalls of the upgrade to ASDF 3:: * What happened to the bundle operations:: Issues with installing the proper version of ASDF @@ -4671,7 +4674,7 @@ while others (like SBCL) will make an attempt at invoking a POSIX shell (and fail if it is not present). @end defun -@node Some Utility Functions, , Controlling source file character encoding, Miscellaneous additional functionality +@node Some Utility Functions, , Miscellaneous Functions, Miscellaneous additional functionality @section Some Utility Functions The below functions are not exported by ASDF itself, but by UIOP, available since ASDF 3. @@ -4893,6 +4896,7 @@ We recommend you control the syntax with such macro as @comment node-name, next, previous, up @chapter Getting the latest version + Decide which version you want. The @code{master} branch is where development happens; its @code{HEAD} is usually OK, including the latest fixes and portability tweaks, @@ -4910,10 +4914,7 @@ You can also browse the repository on @url{https://gitlab.common-lisp.net/asdf/asdf}. Discussion of ASDF development is conducted on the -mailing list -@kbd{asdf-devel@@common-lisp.net}. -@url{http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel} - +mailing list (@pxref{Mailing list}). @node FAQ, Ongoing Work, Getting the latest version, Top @comment node-name, next, previous, up @@ -4921,6 +4922,7 @@ mailing list @menu * Where do I report a bug?:: +* Mailing list:: * What has changed between ASDF 1 ASDF 2 and ASDF 3?:: * Issues with installing the proper version of ASDF:: * Issues with configuring ASDF:: @@ -4928,16 +4930,26 @@ mailing list * ASDF development FAQs:: @end menu -@node Where do I report a bug?, What has changed between ASDF 1 ASDF 2 and ASDF 3?, FAQ, FAQ +@node Where do I report a bug?, Mailing list, FAQ, FAQ @section ``Where do I report a bug?'' - +@cindex bug tracker +@cindex launchpad ASDF bugs are tracked on launchpad: @url{https://launchpad.net/asdf}. If you're unsure about whether something is a bug, or for general discussion, -use the @url{http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel,asdf-devel mailing list} +use the asdf-devel mailing list (@pxref{Mailing list}). + +@node Mailing list, What has changed between ASDF 1 ASDF 2 and ASDF 3?, Where do I report a bug?, FAQ +@section Mailing list +@cindex mailing list + +Discussion of ASDF development is conducted on the +mailing list +@kbd{asdf-devel@@common-lisp.net}. +@url{http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel} -@node What has changed between ASDF 1 ASDF 2 and ASDF 3?, Issues with installing the proper version of ASDF, Where do I report a bug?, FAQ +@node What has changed between ASDF 1 ASDF 2 and ASDF 3?, Issues with installing the proper version of ASDF, Mailing list, FAQ @section ``What has changed between ASDF 1, ASDF 2, and ASDF 3?'' We released ASDF 2.000 on May 31st 2010, @@ -5707,9 +5719,10 @@ ASDF provides a predefined test operation, @code{test-op}. The test operation, however, is largely left to the system definer to specify. @code{test-op} has been a topic of considerable discussion on the -@url{http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel,asdf-devel mailing list}, +@url{http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel,asdf-devel mailing list} +(@pxref{Mailing list}), and on the -@url{https://launchpad.net/asdf,launchpad bug-tracker}. +@url{https://launchpad.net/asdf,launchpad bug-tracker} (@pxref{Where do I report a bug?}). We provide some guidelines in the discussion of @code{test-op}. @c cut the following because it's discussed in the discussion of test-op. -- GitLab