From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/51739 Path: main.gmane.org!not-for-mail From: Reiner Steib <4.uce.03.r.s@nurfuerspam.de> Newsgroups: gmane.emacs.gnus.general,gmane.emacs.gnus.tutorial Subject: Re: [Patch] FAQ in texinfo format Date: Tue, 22 Apr 2003 16:07:56 +0200 Organization: Dept. of Theoretical Physics, University of Ulm Sender: ding-owner@lists.math.uh.edu Message-ID: References: <848yu5dygz.fsf@lucy.is.informatik.uni-duisburg.de> <8765p7embr.fsf@doohan.bang.priv.no> <7nu1cqnbww.fsf@slayer.templeofhate.com> <84lly2x40f.fsf@lucy.is.informatik.uni-duisburg.de> Reply-To: reiner.steib@gmx.de NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: main.gmane.org 1051020546 24123 80.91.224.249 (22 Apr 2003 14:09:06 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Tue, 22 Apr 2003 14:09:06 +0000 (UTC) Cc: faq-discuss@my.gnus.org, gnus-tutorial@socha.net Original-X-From: ding-owner+M282@lists.math.uh.edu Tue Apr 22 16:08:04 2003 Return-path: Original-Received: from malifon.math.uh.edu ([129.7.128.13]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 197yQz-0005r8-00 for ; Tue, 22 Apr 2003 16:07:45 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by malifon.math.uh.edu with smtp (Exim 3.20 #1) id 197yRe-00051h-00; Tue, 22 Apr 2003 09:08:26 -0500 Original-Received: from sclp3.sclp.com ([64.157.176.121]) by malifon.math.uh.edu with smtp (Exim 3.20 #1) id 197yRV-00051Z-00 for ding@lists.math.uh.edu; Tue, 22 Apr 2003 09:08:17 -0500 Original-Received: (qmail 75065 invoked by alias); 22 Apr 2003 14:08:16 -0000 Original-Received: (qmail 75059 invoked from network); 22 Apr 2003 14:08:16 -0000 Original-Received: from main.gmane.org (80.91.224.249) by sclp3.sclp.com with SMTP; 22 Apr 2003 14:08:16 -0000 Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 197yQY-0005oR-00 for ; Tue, 22 Apr 2003 16:07:18 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-To: ding@gnus.org Original-Received: from news by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 197yQX-0005oD-00 for ; Tue, 22 Apr 2003 16:07:17 +0200 Original-Lines: 82 Original-X-Complaints-To: usenet@main.gmane.org Mail-Followup-To: faq-discuss@my.gnus.org, gnus-tutorial@socha.net, ding@gnus.org X-Face: :6KQZ[nyoS_edmB.%gw-=)BYth^|2+Y+^cu%I$FSx!&>-'om>3H7A|M&n(V7fIo3P.;yo.b yq4$p;ZaBtkv)\}biaiBQe"mD}iib1AA@99-fZ7i*bLhNRVC&0Wkxg9)SH?oWc@{ User-Agent: Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.3 (gnu/linux) Cancel-Lock: sha1:PHa15pt7FVAot1zv/5pi7P3bzBM= Precedence: bulk Xref: main.gmane.org gmane.emacs.gnus.general:51739 gmane.emacs.gnus.tutorial:1 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:51739 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:51739 On Tue, Apr 22 2003, Kai Großjohann wrote: > Frank Schmitt writes: > >> Is putting it under Appendix really a good idea? It's quite hidden >> there. ACK. The old version of the FAQ has been there, so I though that the new version should be placed there too. >> What was wrong with having it as a seperate info file? > Let's put it in a more prominent place, ACK. > but in the general Gnus info file. I'm not sure. > There are so many info files for Gnus, people don't read them anyway > :-( Gnus, Message, Emacs-MIME come to mind at least. ... and Sieve and PGG. But as we have menu items for those in (info "(gnus)Top") under "Other related manuals", it should be more easy to find them. I guess we cannot include the manuals for message etc. into gnus.texi, because those are libraries, that are supposed to be independent of Gnus. This argument doesn't hold for the Gnus FAQ. Instead of putting the FAQ as a @section in the "@chapter Appendices", it could be a @chapter, included e.g. before "@chapter Appendices". When included in `gnus.texi', we must take care not to have duplicate node names (this is why I prepended "FAQ"). If we choose the `separate info file' approach, we need to add links to the FAQ under "Other related manuals". And, as @menu is invisible in dvi/ps/pdf output, we should add some hints in the printed versions too (also for Message, Emacs-MIME, Sieve, PGG). We can revert gnus-faq.texi to Frank's version (revision 6.9) then, but we need to fix gnus.texi[1]. Aside from the Gnus FAQ, there may be other documents to be distributed along with Gnus, so we should come to some kind of general guidelines, how to include (or refer to) those documents: - Translations of docs to non-English languages, e.g. Xavier Maillard's French docs. - The Gnus Tutorial: It's development seems to be stalled. But anyhow, I think after some minor fixes, we should add it to the Gnus distribution. Contributions and corrections welcome! [2] [ Cc: faq-discuss@my.gnus.org, gnus-tutorial@socha.net ] Bye, Reiner. [1] ./gnus-faq.texi:11: Node `Top' previously defined at line 380. ./gnus-faq.texi:12: Node with @top as a section already exists. ./gnus.texi:380: Here is the @top node. ./gnus.texi:26513: Next reference to nonexistent node `Frequently Asked Questions' (perhaps incorrect sectioning?). ./gnus.texi:380: Node `Top' lacks menu item for `Introduction' despite being its Up target. ./gnus.texi:380: Node `Top' lacks menu item for `Frequently Asked Questions with Answers' despite being its Up target. ./gnus.texi:380: Node `Top' lacks menu item for `Glossary' despite being its Up target. ./gnus.texi:23097: Menu reference to nonexistent node `Frequently Asked Questions' (perhaps incorrect sectioning?). ./gnus.texi:872: Cross reference to nonexistent node `Frequently Asked Questions' (perhaps incorrect sectioning?). makeinfo: Removing output file `gnus' due to errors; use --force to preserve. [2] cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gnus login cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gnus co gnus-tutorial -- ,,, (o o) ---ooO-(_)-Ooo--- PGP key available via WWW http://rsteib.home.pages.de/