* bug#1988: Making the license statement visible in the Emacs Manual @ 2009-01-22 8:16 Jesse W 2009-01-26 7:38 ` Glenn Morris 0 siblings, 1 reply; 17+ messages in thread From: Jesse W @ 2009-01-22 8:16 UTC (permalink / raw) To: bug-gnu-emacs Currently, in the displayed HTML of the Emacs Manual, there is nothing the specifically says it is released under the GFDL (GNU Free Documentation License), and what the Invariant Sections and Cover-Texts are. It's in an HTML comment, but there isn't even a note in the rendered text to tell you to look there. This makes it more likely that people will mis-use the text, by presuming it's under the GFDL without any Invariant Sections, and in other ways. I heard that this had been discussed earlier, but I was unable to find it in the archives of gnu.emacs.bug, so I'm bringing it up again. Jesse Weinstein ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-22 8:16 bug#1988: Making the license statement visible in the Emacs Manual Jesse W @ 2009-01-26 7:38 ` Glenn Morris 2009-01-26 18:33 ` Jesse W 0 siblings, 1 reply; 17+ messages in thread From: Glenn Morris @ 2009-01-26 7:38 UTC (permalink / raw) To: Jesse W; +Cc: 1988 Jesse W wrote: > Currently, in the displayed HTML of the Emacs Manual, there is nothing > the specifically says it is released under the GFDL (GNU Free > Documentation License), and what the Invariant Sections and Cover-Texts > are. It's in an HTML comment, but there isn't even a note in the > rendered text to tell you to look there. The Emacs manual uses the standard texinfo @copying command to specify this information; so I'd say that this was a texinfo issue rather than an Emacs issue. Perhaps you can check on the texinfo list (?) if this has been discussed? ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-26 7:38 ` Glenn Morris @ 2009-01-26 18:33 ` Jesse W 2009-01-26 18:41 ` Glenn Morris 0 siblings, 1 reply; 17+ messages in thread From: Jesse W @ 2009-01-26 18:33 UTC (permalink / raw) To: Glenn Morris; +Cc: 1988 On Jan 25, 2009, at 11:38 PM, Glenn Morris wrote: > Jesse W wrote: >> Currently, in the displayed HTML of the Emacs Manual, there is nothing >> the specifically says it is released under the GFDL (GNU Free >> Documentation License), and what the Invariant Sections and >> Cover-Texts >> are. It's in an HTML comment, but there isn't even a note in the >> rendered text to tell you to look there. > > The Emacs manual uses the standard texinfo @copying command to specify > this information; so I'd say that this was a texinfo issue rather than > an Emacs issue. Perhaps you can check on the texinfo list (?) if this > has been discussed? There is a specific texinfo @ command, @insertcopying, which is designed to make the @copying information visible. See http://www.gnu.org/software/texinfo/manual/texinfo/html_node/ insertcopying.html#insertcopying There does not seem to have been discussion about it on the texinfo-bug list. I'm suggesting that the Emacs Manual be modified either to 1) Include the @insertcopying command at the beginning of the document, so the license grant is visible in all the formats, or 2) Insert a note that tells people to look in the HTML/texinfo source code for the license grant. This is not a texinfo problem. Jesse Weinstein ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-26 18:33 ` Jesse W @ 2009-01-26 18:41 ` Glenn Morris 2009-01-26 21:28 ` Jesse W 2009-01-26 22:45 ` Eli Zaretskii 0 siblings, 2 replies; 17+ messages in thread From: Glenn Morris @ 2009-01-26 18:41 UTC (permalink / raw) To: Jesse W; +Cc: 1988 Jesse W wrote: > There is a specific texinfo @ command, @insertcopying, which is > designed to make the @copying information visible. See > http://www.gnu.org/software/texinfo/manual/texinfo/html_node/ > insertcopying.html#insertcopying This command is already used in the Emacs manual, in what I believe is the way texinfo recommends. It only affects the printed titlepage. See: http://www.gnu.org/software/hello/manual/texinfo/GNU-Sample-Texts.html#GNU-Sample-Texts http://cvs.savannah.gnu.org/viewvc/emacs/doc/emacs/emacs.texi?root=emacs&view=markup The latter looks consistent with the former AFAICS. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-26 18:41 ` Glenn Morris @ 2009-01-26 21:28 ` Jesse W 2009-01-26 22:45 ` Eli Zaretskii 1 sibling, 0 replies; 17+ messages in thread From: Jesse W @ 2009-01-26 21:28 UTC (permalink / raw) To: Glenn Morris; +Cc: 1988 On Jan 26, 2009, at 10:41 AM, Glenn Morris wrote: > Jesse W wrote: > >> There is a specific texinfo @ command, @insertcopying, which is >> designed to make the @copying information visible. See >> http://www.gnu.org/software/texinfo/manual/texinfo/html_node/ >> insertcopying.html#insertcopying > > This command is already used in the Emacs manual, in what I believe is > the way texinfo recommends. It only affects the printed titlepage. I'm glad to see that the license grant appears on the printed format; however, that doesn't resolve the problem that it's impossible for someone reading the plain-text version, or reading the HTML without looking at the source, to tell what the license grant is (specifically, the inclusion of Invariant Sections). It is quite feasible to include either the full license grant, or a note referring to where it is, by using @ifhtml and @ifplain directives. It may *also* be good to modify the Sample Texts to include this, but, the Emacs Manual can be fixed in any case. Jesse Weinstein ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-26 18:41 ` Glenn Morris 2009-01-26 21:28 ` Jesse W @ 2009-01-26 22:45 ` Eli Zaretskii 2009-01-27 22:59 ` Richard M Stallman 1 sibling, 1 reply; 17+ messages in thread From: Eli Zaretskii @ 2009-01-26 22:45 UTC (permalink / raw) To: Glenn Morris, 1988; +Cc: 1988, jessw > Date: Mon, 26 Jan 2009 13:41:44 -0500 > Cc: 1988@emacsbugs.donarmstrong.com > > Jesse W wrote: > > > There is a specific texinfo @ command, @insertcopying, which is > > designed to make the @copying information visible. See > > http://www.gnu.org/software/texinfo/manual/texinfo/html_node/ > > insertcopying.html#insertcopying > > This command is already used in the Emacs manual, in what I believe is > the way texinfo recommends. It only affects the printed titlepage. It only affects the titlepage because it appears within the @titlepage block. To make it appear in the HTML output, not as HTML comment which is not displayed by the browser, you need @insertcopying in the body of the manual, inside @ifnottex..@end ifnottex. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-26 22:45 ` Eli Zaretskii @ 2009-01-27 22:59 ` Richard M Stallman 2009-01-28 4:04 ` Eli Zaretskii 0 siblings, 1 reply; 17+ messages in thread From: Richard M Stallman @ 2009-01-27 22:59 UTC (permalink / raw) To: Eli Zaretskii, 1988; +Cc: karl, jessw I suggest talking with the Texinfo maintainer, karl@gnu.org, about this. If the Texinfo manual doesn't give clear and specific advice which settles your question, then I think some should be added there. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-27 22:59 ` Richard M Stallman @ 2009-01-28 4:04 ` Eli Zaretskii 2009-01-28 23:38 ` Karl Berry 0 siblings, 1 reply; 17+ messages in thread From: Eli Zaretskii @ 2009-01-28 4:04 UTC (permalink / raw) To: rms; +Cc: jessw, karl, 1988 > From: Richard M Stallman <rms@gnu.org> > CC: rgm@gnu.org, jessw@netwood.net > cc: karl@gnu.org > Date: Tue, 27 Jan 2009 17:59:13 -0500 > > I suggest talking with the Texinfo maintainer, karl@gnu.org, about this. > If the Texinfo manual doesn't give clear and specific advice which settles > your question, then I think some should be added there. The Texinfo manual _does_ give clear and specific advice about this: We also strongly recommend using `@insertcopying' in the Top node of your manual (*note The Top Node::), although it is not required legally. Here's why: The `@copying' command itself causes the permissions text to appear in an Info file _before_ the first node. The text is also copied into the beginning of each split Info output file, as is legally necessary. This location implies a human reading the manual using Info does _not_ see this text (except when using the advanced Info command `g *'). Therefore, an explicit `@insertcopying' in the Top node makes it apparent to readers that the manual is free. Similarly, the `@copying' text is automatically included at the beginning of each HTML output file, as an HTML comment. Again, this text is not visible (unless the reader views the HTML source). And therefore again, the `@insertcopying' in the Top node is valuable because it makes the copying permissions visible and thus promotes freedom. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-28 4:04 ` Eli Zaretskii @ 2009-01-28 23:38 ` Karl Berry 2009-01-29 0:25 ` Jesse W 0 siblings, 1 reply; 17+ messages in thread From: Karl Berry @ 2009-01-28 23:38 UTC (permalink / raw) To: eliz; +Cc: jessw, 1988, rms eliz> The Texinfo manual _does_ give clear and specific advice about this: Yeah. Here is the message I sent to rms, Stefan, and Chong a few days ago when rms first pinged me about this. jessw@netwood.net> Currently, in the displayed HTML of the Emacs jessw@netwood.net> Manual, there is nothing the specifically says it jessw@netwood.net> is released under the GFDL rms [to karl]> Can you fix this and ack? I can imagine either: 1) adding @insertcopying to the Top node, which is simple but adds ~20 lines of text (the full copying notice), or 2) adding just a sentence saying to look at the source for the precise conditions, something like this: This manual is released under the GNU Free Documentation License. For the full copying conditions, please view the full source for this formatted file (e.g., @code{g*} in Info, View Source in HTML). Do any of you have a preference for which way to go? Also, related to this, right now the copying notice does not show up in the plain text output at all, since there is separate "source" for the formatted version. Therefore I think the Top node should include the following in any case: @ifplaintext @insertcopying @end ifplaintext Whatever way we go, I guess all the manuals need to follow suit. Which makes me somewhat want to just use @insertcopying since it is the simplest thing to do. karl ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-28 23:38 ` Karl Berry @ 2009-01-29 0:25 ` Jesse W 2009-02-01 14:37 ` Karl Berry 0 siblings, 1 reply; 17+ messages in thread From: Jesse W @ 2009-01-29 0:25 UTC (permalink / raw) To: Karl Berry; +Cc: 1988, rms On Jan 28, 2009, at 3:38 PM, Karl Berry wrote: > I can imagine either: > > 1) adding @insertcopying to the Top node, which is simple but adds ~20 > lines of text (the full copying notice), or > > 2) adding just a sentence saying to look at the source for the precise > conditions, something like this: > > This manual is released under the GNU Free Documentation License. > For the full copying conditions, please view the full source for > this formatted file (e.g., @code{g*} in Info, View Source in > HTML). > > Do any of you have a preference for which way to go? Simply adding @insertcopying seems best to me, but any of the alternatives are fine. If it would help, I'd be happy to make patches for the various manuals. Jesse Weinstein ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-01-29 0:25 ` Jesse W @ 2009-02-01 14:37 ` Karl Berry 2009-02-05 9:29 ` Jesse W 0 siblings, 1 reply; 17+ messages in thread From: Karl Berry @ 2009-02-01 14:37 UTC (permalink / raw) To: jessw, 1988 Jesse, Simply adding @insertcopying seems best to me, but any of the alternatives are fine. If it would help, I'd be happy to make patches for the various manuals. Since evidently no one else has a strong opinion, I suggest we go with the plain @insertcopying. It would be great if you could prepare the patches. Thanks. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-02-01 14:37 ` Karl Berry @ 2009-02-05 9:29 ` Jesse W 2009-02-06 0:05 ` Karl Berry 0 siblings, 1 reply; 17+ messages in thread From: Jesse W @ 2009-02-05 9:29 UTC (permalink / raw) To: Karl Berry; +Cc: 1988 [-- Attachment #1: Type: text/plain, Size: 352 bytes --] On Feb 1, 2009, at 6:37 AM, Karl Berry wrote: > Since evidently no one else has a strong opinion, I suggest we go with > the plain @insertcopying. It would be great if you could prepare the > patches. Thanks. Well, here is a simple patch for emacs.texi. I hope I did it right, please let me know if there's any better way I should do this. Jesse [-- Attachment #2: emacs_insertcopying.patch --] [-- Type: application/octet-stream, Size: 483 bytes --] Index: emacs.texi =================================================================== RCS file: /sources/emacs/emacs/doc/emacs/emacs.texi,v retrieving revision 1.37 diff -u -r1.37 emacs.texi --- emacs.texi 1 Feb 2009 22:04:25 -0000 1.37 +++ emacs.texi 5 Feb 2009 09:26:50 -0000 @@ -1071,6 +1071,10 @@ @xref{Mac OS}, for information about using Emacs on Macintosh. @end iftex +@ifnottex +@insertcopying +@end ifnottex + @node Distrib, Intro, Top, Top @unnumbered Distribution [-- Attachment #3: Type: text/plain, Size: 1 bytes --] ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-02-05 9:29 ` Jesse W @ 2009-02-06 0:05 ` Karl Berry 2009-02-06 19:03 ` Jesse W 0 siblings, 1 reply; 17+ messages in thread From: Karl Berry @ 2009-02-06 0:05 UTC (permalink / raw) To: jessw; +Cc: 1988 Well, here is a simple patch for emacs.texi. I hope I did it right, please let me know if there's any better way I should do this. I'm not sure if anyone will see it after the lengthy menu in the Top node, but if you're happy with it (as the original bug reporter), it's fine with me. Can you go through and make the same change to all the other manuals and send me the diff? Thanks. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-02-06 0:05 ` Karl Berry @ 2009-02-06 19:03 ` Jesse W 2009-02-06 23:02 ` Karl Berry 0 siblings, 1 reply; 17+ messages in thread From: Jesse W @ 2009-02-06 19:03 UTC (permalink / raw) To: Karl Berry; +Cc: 1988 [-- Attachment #1: Type: text/plain, Size: 518 bytes --] On Feb 5, 2009, at 4:05 PM, Karl Berry wrote: > Well, here is a simple patch for emacs.texi. I hope I did it > right, > please let me know if there's any better way I should do this. > > I'm not sure if anyone will see it after the lengthy menu in the Top > node, but if you're happy with it (as the original bug reporter), it's > fine with me. On review, I think you're right. I was being overly cautious. Here's a patch that puts it right in the opening screenfull, where it certainly won't be missed. [-- Attachment #2: emacs_insertcopying.patch --] [-- Type: application/octet-stream, Size: 742 bytes --] Index: emacs.texi =================================================================== RCS file: /sources/emacs/emacs/doc/emacs/emacs.texi,v retrieving revision 1.37 diff -u -r1.37 emacs.texi --- emacs.texi 1 Feb 2009 22:04:25 -0000 1.37 +++ emacs.texi 6 Feb 2009 18:43:03 -0000 @@ -99,9 +99,10 @@ @top The Emacs Editor Emacs is the extensible, customizable, self-documenting real-time -display editor. This Info file describes how to edit with Emacs and -some of how to customize it; it corresponds to GNU Emacs version -@value{EMACSVER}. +display editor. This Info file describes how to edit with Emacs and +some of how to customize it. + +@insertcopying @ifinfo To learn more about the Info documentation system, type @kbd{h}, and [-- Attachment #3: Type: text/plain, Size: 322 bytes --] > Can you go through and make the same change to all the other manuals > and > send me the diff? Certainly. By "the other manuals" I assume you mean those listed on: http://www.gnu.org/manual/manual.html -- or is there some other, more accessible list? In any case, just to start, here's a patch for EMMS's manual. [-- Attachment #4: emms_insertcopying.patch --] [-- Type: application/octet-stream, Size: 360 bytes --] --- emms.texinfo.orig Fri Feb 6 10:58:14 2009 +++ emms.texinfo Fri Feb 6 10:59:59 2009 @@ -45,7 +45,10 @@ @node Top, Introduction, (dir), (dir) @top Emms Manual -This is the Manual for the Emacs Multimedia System +This is the Manual for the Emacs Multimedia System. + +@insertcopying + @menu Starting out * Introduction:: Introduction to Emms. [-- Attachment #5: Type: text/plain, Size: 236 bytes --] BTW, (I know this should likely be mentioned elsewhere, but...) GNUMP3d should probably be noted as being "mothballed" per it's developer's comment here: http://www.gnu.org/software/gnump3d/index.html Glad to help, Jesse Weinstein ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-02-06 19:03 ` Jesse W @ 2009-02-06 23:02 ` Karl Berry 2009-02-08 19:38 ` Jesse W 0 siblings, 1 reply; 17+ messages in thread From: Karl Berry @ 2009-02-06 23:02 UTC (permalink / raw) To: jessw; +Cc: 1988 On review, I think you're right. I was being overly cautious. Here's a patch that puts it right in the opening screenfull, where it certainly won't be missed. Ok. Certainly. By "the other manuals" I assume you mean those listed on: http://www.gnu.org/manual/manual.html -- No. Sorry for not specifying. I just mean the manuals in the Emacs distribution, namely those here: http://cvs.savannah.gnu.org/viewvc/emacs/doc/?root=emacs (There are many individual manuals in the misc/ subdir.) Dealing with manuals in other distributions has to be done separately, through their respective maintainers/bug lists. If you want to take that on, that would be great. BTW, (I know this should likely be mentioned elsewhere, but...) GNUMP3d should probably be noted as being "mothballed" per it's developer's comment here: http://www.gnu.org/software/gnump3d/index.html Hmm, thanks for mentioning it. I guess I'll be writing to its maintainer. ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-02-06 23:02 ` Karl Berry @ 2009-02-08 19:38 ` Jesse W 2009-02-16 17:50 ` Karl Berry 0 siblings, 1 reply; 17+ messages in thread From: Jesse W @ 2009-02-08 19:38 UTC (permalink / raw) To: Karl Berry; +Cc: 1988 [-- Attachment #1: Type: text/plain, Size: 1644 bytes --] Whew, that was a lot of files... On Feb 6, 2009, at 3:02 PM, Karl Berry wrote: > No. Sorry for not specifying. I just mean the manuals in the Emacs > distribution, namely those here: > http://cvs.savannah.gnu.org/viewvc/emacs/doc/?root=emacs > > (There are many individual manuals in the misc/ subdir.) Oh, /those/ manuals... ;-) OK, here they are. calc.texi had the copyright date line repeated on the title page, so I removed the redundant one. dbus.texi already included @insertcopying, as far back as its initial revision about a year ago. erc.texi is the same. faq.texi isn't under the GFDL, rather it's under a vague copyleft statement, with copyright dates going back to 1990. gnus-faq.texi claims to be generated from an XML file, which I can't find (the given URL breaks, the gnus.org site does not appear to have the purported XML file visible anywhere..), so I'm leaving that one aside for now. gnus-news.texi is also not under GFDL, and has it's copyright statement in a comment, so we'll leave that one alone, too. gnus.texi already has @insertcopying. mh-e.texi is dual-licensed under the GFDL 1.3+ and the GPL 3+, and already has @insertcopying. org.texi already has @insertcopying. remember.texi does too. smtpmail.texi also. tramp.texi has @insertcopying at the bottom of the Top node. trampver.texi isn't exactly a manual, and has it's license statement in a comment; ignoring. Quite a few of them repeated a descriptive line in @copying and in the top of the Top node; I removed the repeats where I saw them. And that's it... all the others are included in the big-pile-o-patch attached below. [-- Attachment #2: emacs_misc_manuals_insertcopying.patch --] [-- Type: application/octet-stream, Size: 18689 bytes --] Index: ada-mode.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/ada-mode.texi,v retrieving revision 1.9 diff -u -r1.9 ada-mode.texi --- ada-mode.texi 5 Feb 2009 23:38:36 -0000 1.9 +++ ada-mode.texi 8 Feb 2009 19:18:46 -0000 @@ -42,6 +42,10 @@ @node Top, Overview, (dir), (dir) +@ifnottex +@insertcopying +@end ifnottex + @menu * Overview:: * Installation:: Installing Ada mode on your system Index: autotype.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/autotype.texi,v retrieving revision 1.7 diff -u -r1.7 autotype.texi --- autotype.texi 8 Jan 2009 05:29:05 -0000 1.7 +++ autotype.texi 8 Feb 2009 19:18:51 -0000 @@ -100,7 +100,9 @@ * Variable Index:: @end menu - +@ifnottex +@insertcopying +@end ifnottex @node Using Skeletons @chapter Using Skeletons Index: calc.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/calc.texi,v retrieving revision 1.31 diff -u -r1.31 calc.texi --- calc.texi 27 Jan 2009 01:54:38 -0000 1.31 +++ calc.texi 8 Feb 2009 19:23:06 -0000 @@ -127,8 +127,6 @@ @page @vskip 0pt plus 1filll -Copyright @copyright{} 1990, 1991, 2001, 2002, 2003, 2004, - 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. @insertcopying @end titlepage @@ -144,6 +142,8 @@ @node Top, Getting Started, (dir), (dir) @chapter The GNU Emacs Calculator +@insertcopying + @noindent @dfn{Calc} is an advanced desk calculator and mathematical tool written by Dave Gillespie that runs as part of the GNU Emacs environment. Index: cc-mode.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/cc-mode.texi,v retrieving revision 1.12 diff -u -r1.12 cc-mode.texi --- cc-mode.texi 8 Jan 2009 05:29:06 -0000 1.12 +++ cc-mode.texi 8 Feb 2009 19:23:49 -0000 @@ -225,6 +225,10 @@ functions, classes etc - there are other packages for that. @end ifinfo +@ifnottex +@insertcopying +@end ifnottex + @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Index: cl.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/cl.texi,v retrieving revision 1.12 diff -u -r1.12 cl.texi --- cl.texi 8 Jan 2009 05:29:07 -0000 1.12 +++ cl.texi 8 Feb 2009 19:24:28 -0000 @@ -47,6 +47,10 @@ @node Top, Overview, (dir), (dir) @chapter Introduction +@ifnottex +@insertcopying +@end ifnottex + @noindent This document describes a set of Emacs Lisp facilities borrowed from Common Lisp. All the facilities are described here in detail. While Index: dired-x.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/dired-x.texi,v retrieving revision 1.10 diff -u -r1.10 dired-x.texi --- dired-x.texi 8 Jan 2009 05:29:07 -0000 1.10 +++ dired-x.texi 8 Feb 2009 19:24:35 -0000 @@ -84,6 +84,8 @@ @item For @file{dired-x.el} revision 2 +@insertcopying + @c @item @c Revision of this manual: 2.53 (2001/02/25 14:05:46) Index: ebrowse.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/ebrowse.texi,v retrieving revision 1.7 diff -u -r1.7 ebrowse.texi --- ebrowse.texi 8 Jan 2009 05:29:07 -0000 1.7 +++ ebrowse.texi 8 Feb 2009 19:24:41 -0000 @@ -46,6 +46,8 @@ @node Top, Overview, (dir), (dir) @ifnottex +@insertcopying + You can browse C++ class hierarchies from within Emacs by using Ebrowse. @end ifnottex Index: ediff.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/ediff.texi,v retrieving revision 1.9 diff -u -r1.9 ediff.texi --- ediff.texi 8 Jan 2009 05:29:08 -0000 1.9 +++ ediff.texi 8 Feb 2009 19:25:04 -0000 @@ -64,6 +64,7 @@ @node Top, Introduction, (dir), (dir) +@insertcopying @menu * Introduction:: About Ediff. Index: emacs-mime.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/emacs-mime.texi,v retrieving revision 1.9 diff -u -r1.9 emacs-mime.texi --- emacs-mime.texi 8 Jan 2009 05:29:08 -0000 1.9 +++ emacs-mime.texi 8 Feb 2009 19:25:14 -0000 @@ -50,6 +50,10 @@ @node Top @top Emacs MIME +@ifnottex +@insertcopying +@end ifnottex + This manual documents the libraries used to compose and display @acronym{MIME} messages. Index: epa.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/epa.texi,v retrieving revision 1.10 diff -u -r1.10 epa.texi --- epa.texi 8 Jan 2009 05:29:08 -0000 1.10 +++ epa.texi 8 Feb 2009 19:25:16 -0000 @@ -54,6 +54,10 @@ @node Top @top EasyPG Assistant user's manual +@ifnottex +@insertcopying +@end ifnottex + EasyPG Assistant is an Emacs user interface to GNU Privacy Guard (GnuPG, @pxref{Top, , Top, gnupg, Using the GNU Privacy Guard}). Index: eshell.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/eshell.texi,v retrieving revision 1.7 diff -u -r1.7 eshell.texi --- eshell.texi 8 Jan 2009 05:29:08 -0000 1.7 +++ eshell.texi 8 Feb 2009 19:25:24 -0000 @@ -64,7 +64,9 @@ @node Top, What is Eshell?, (dir), (dir) @top Eshell -This manual documents Eshell, a shell-like command interpretor +@insertcopying + +Eshell is a shell-like command interpretor implemented in Emacs Lisp. It invokes no external processes except for those requested by the user. It is intended to be a functional replacement for command shells such as @command{bash}, @command{zsh}, Index: eudc.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/eudc.texi,v retrieving revision 1.7 diff -u -r1.7 eudc.texi --- eudc.texi 8 Jan 2009 05:29:08 -0000 1.7 +++ eudc.texi 8 Feb 2009 19:25:28 -0000 @@ -51,12 +51,7 @@ @node Top, Overview, (dir), (dir) @comment node-name, next, previous, up - -This manual documents EUDC v1.30b, the Emacs Unified Directory Client. - -A common interface to directory servers using various protocols such as -LDAP or the CCSO white pages directory system (PH/QI) - +@insertcopying @end ifnottex @menu Index: faq.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/faq.texi,v retrieving revision 1.8 diff -u -r1.8 faq.texi --- faq.texi 1 Feb 2009 22:04:26 -0000 1.8 +++ faq.texi 8 Feb 2009 19:26:06 -0000 @@ -64,6 +64,10 @@ or have any suggestions, please use @kbd{M-x report-emacs-bug} to report them. +@ifnottex +@insertcopying +@end ifnottex + @menu * FAQ notation:: * General questions:: Index: flymake.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/flymake.texi,v retrieving revision 1.9 diff -u -r1.9 flymake.texi --- flymake.texi 8 Jan 2009 05:29:09 -0000 1.9 +++ flymake.texi 8 Feb 2009 19:26:08 -0000 @@ -47,6 +47,7 @@ @ifnottex @node Top @top GNU Flymake +@insertcopying @end ifnottex @menu Index: forms.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/forms.texi,v retrieving revision 1.7 diff -u -r1.7 forms.texi --- forms.texi 8 Jan 2009 05:29:09 -0000 1.7 +++ forms.texi 8 Feb 2009 19:26:14 -0000 @@ -62,6 +62,8 @@ @node Top @top Forms Mode +@insertcopying + Forms mode is an Emacs major mode for working with simple textual data bases in a forms-oriented manner. In Forms mode, the information in these files is presented in an Emacs window in a user-defined format, Index: gnus-coding.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/gnus-coding.texi,v retrieving revision 1.7 diff -u -r1.7 gnus-coding.texi --- gnus-coding.texi 8 Jan 2009 05:29:09 -0000 1.7 +++ gnus-coding.texi 8 Feb 2009 19:26:16 -0000 @@ -45,6 +45,9 @@ @node Top @top Gnus Coding Style and Maintainance Guide This manual describes @dots{} + +@insertcopying + @menu * Gnus Coding Style:: Gnus Coding Style * Gnus Maintainance Guide:: Gnus Maintainance Guide Index: idlwave.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/idlwave.texi,v retrieving revision 1.7 diff -u -r1.7 idlwave.texi --- idlwave.texi 8 Jan 2009 05:29:11 -0000 1.7 +++ idlwave.texi 8 Feb 2009 19:26:48 -0000 @@ -60,6 +60,8 @@ @node Top, Introduction, (dir), (dir) +@insertcopying + IDLWAVE is a package which supports editing source code written in the Interactive Data Language (IDL), and running IDL as an inferior shell. Index: info.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/info.texi,v retrieving revision 1.10 diff -u -r1.10 info.texi --- info.texi 8 Jan 2009 05:29:11 -0000 1.10 +++ info.texi 8 Feb 2009 19:26:59 -0000 @@ -58,6 +58,8 @@ @node Top @top Info: An Introduction +@insertcopying + The GNU Project distributes most of its on-line manuals in the @dfn{Info format}, which you read using an @dfn{Info reader}. You are probably using an Info reader to read this now. Index: mairix-el.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/mairix-el.texi,v retrieving revision 1.4 diff -u -r1.4 mairix-el.texi --- mairix-el.texi 8 Jan 2009 05:29:11 -0000 1.4 +++ mairix-el.texi 8 Feb 2009 19:27:02 -0000 @@ -50,6 +50,8 @@ @file{.emacs} for future use and lets you call mairix for updating the database. +@insertcopying + @menu * About mairix and mairix.el:: About the mairix search engine and mairix.el * Configuring mairix:: How to configure mairix Index: message.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/message.texi,v retrieving revision 1.12 diff -u -r1.12 message.texi --- message.texi 8 Jan 2009 05:29:11 -0000 1.12 +++ message.texi 8 Feb 2009 19:27:15 -0000 @@ -48,6 +48,10 @@ @node Top @top Message +@ifnottex +@insertcopying +@end ifnottex + All message composition from Gnus (both mail and news) takes place in Message mode buffers. Index: newsticker.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/newsticker.texi,v retrieving revision 1.8 diff -u -r1.8 newsticker.texi --- newsticker.texi 8 Jan 2009 05:29:11 -0000 1.8 +++ newsticker.texi 8 Feb 2009 19:27:17 -0000 @@ -51,6 +51,9 @@ @ifnottex @node Top @top Newsticker + +@insertcopying + @end ifnottex @menu Index: nxml-mode.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/nxml-mode.texi,v retrieving revision 1.8 diff -u -r1.8 nxml-mode.texi --- nxml-mode.texi 8 Jan 2009 05:29:12 -0000 1.8 +++ nxml-mode.texi 8 Feb 2009 19:27:22 -0000 @@ -39,8 +39,9 @@ @node Top @top nXML Mode -This manual documents nxml-mode, an Emacs major mode for editing -XML with RELAX NG support. This manual is not yet complete. +@insertcopying + +This manual is not yet complete. @menu * Completion:: Index: pcl-cvs.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/pcl-cvs.texi,v retrieving revision 1.8 diff -u -r1.8 pcl-cvs.texi --- pcl-cvs.texi 8 Jan 2009 05:29:12 -0000 1.8 +++ pcl-cvs.texi 8 Feb 2009 19:27:31 -0000 @@ -68,6 +68,9 @@ customize-group RET pcl-cvs @key{RET}} and to look at the documentation strings of the various commands and major modes for further information. @c This manual is updated to release 2.5 of PCL-CVS. + +@insertcopying + @end ifnottex @menu Index: pgg.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/pgg.texi,v retrieving revision 1.7 diff -u -r1.7 pgg.texi --- pgg.texi 8 Jan 2009 05:29:12 -0000 1.7 +++ pgg.texi 8 Feb 2009 19:27:34 -0000 @@ -46,7 +46,10 @@ @node Top @top PGG -This manual describes PGG. PGG is an interface library between Emacs + +@insertcopying + +PGG is an interface library between Emacs and various tools for secure communication. PGG also provides a simple user interface to encrypt, decrypt, sign, and verify MIME messages. Index: rcirc.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/rcirc.texi,v retrieving revision 1.15 diff -u -r1.15 rcirc.texi --- rcirc.texi 8 Jan 2009 05:29:12 -0000 1.15 +++ rcirc.texi 8 Feb 2009 19:27:39 -0000 @@ -36,6 +36,9 @@ @ifnottex @node Top, Basics, (dir), (dir) @top rcirc Manual + +@insertcopying + @end ifnottex @code{rcirc} is an Emacs IRC client. Index: reftex.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/reftex.texi,v retrieving revision 1.7 diff -u -r1.7 reftex.texi --- reftex.texi 8 Jan 2009 05:29:13 -0000 1.7 +++ reftex.texi 8 Feb 2009 19:28:17 -0000 @@ -77,6 +77,8 @@ @ifnottex @node Top,,,(dir) +@insertcopying + @b{Ref@TeX{}} is a package for managing Labels, References, Citations and index entries with GNU Emacs. Index: sasl.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/sasl.texi,v retrieving revision 1.7 diff -u -r1.7 sasl.texi --- sasl.texi 8 Jan 2009 05:29:13 -0000 1.7 +++ sasl.texi 8 Feb 2009 19:28:18 -0000 @@ -54,9 +54,10 @@ @node Top @top Emacs SASL -This manual describes the Emacs SASL library. -A common interface to share several authentication mechanisms between +@insertcopying + +SASL is a common interface to share several authentication mechanisms between applications using different protocols. @menu Index: sc.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/sc.texi,v retrieving revision 1.8 diff -u -r1.8 sc.texi --- sc.texi 8 Jan 2009 05:29:13 -0000 1.8 +++ sc.texi 8 Feb 2009 19:28:36 -0000 @@ -53,8 +53,9 @@ @node Top, Introduction, (dir), (dir) @comment node-name, next, previous, up -This document describes Supercite, an Emacs package for citing and -attributing replies to mail and news messages. The manual is divided +@insertcopying + +The manual is divided into the following chapters. @menu Index: ses.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/ses.texi,v retrieving revision 1.9 diff -u -r1.9 ses.texi --- ses.texi 8 Jan 2009 05:29:13 -0000 1.9 +++ ses.texi 8 Feb 2009 19:28:42 -0000 @@ -55,6 +55,8 @@ @comment node-name, next, previous, up @top SES: Simple Emacs Spreadsheet +@insertcopying + @display SES is a major mode for GNU Emacs to edit spreadsheet files, which contain a rectangular grid of cells. The cells' values are specified Index: sieve.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/sieve.texi,v retrieving revision 1.8 diff -u -r1.8 sieve.texi --- sieve.texi 8 Jan 2009 05:29:13 -0000 1.8 +++ sieve.texi 8 Feb 2009 19:28:43 -0000 @@ -48,9 +48,11 @@ @node Top @top Sieve Support for Emacs -This manual documents the Emacs Sieve package. +@ifnottex +@insertcopying +@end ifnottex -It is intended as a users manual for Sieve Mode and Manage Sieve, and +This is intended as a users manual for Sieve Mode and Manage Sieve, and as a reference manual for the @samp{sieve-manage} protocol Emacs Lisp API. Index: speedbar.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/speedbar.texi,v retrieving revision 1.6 diff -u -r1.6 speedbar.texi --- speedbar.texi 8 Jan 2009 05:29:14 -0000 1.6 +++ speedbar.texi 8 Feb 2009 19:28:52 -0000 @@ -41,6 +41,8 @@ @node Top, , , (dir)Top @comment node-name, next, previous, up +@insertcopying + Speedbar is a program for Emacs which can be used to summarize information related to the current buffer. Its original inspiration is the `explorer' often used in modern development environments, office Index: url.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/url.texi,v retrieving revision 1.8 diff -u -r1.8 url.texi --- url.texi 8 Jan 2009 05:29:14 -0000 1.8 +++ url.texi 8 Feb 2009 19:29:00 -0000 @@ -53,6 +53,9 @@ @node Top @top URL +@ifnottex +@insertcopying +@end ifnottex @menu * Getting Started:: Preparing your program to use URLs. Index: vip.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/vip.texi,v retrieving revision 1.7 diff -u -r1.7 vip.texi --- vip.texi 8 Jan 2009 05:29:14 -0000 1.7 +++ vip.texi 8 Feb 2009 19:29:13 -0000 @@ -45,6 +45,8 @@ @node Top, Survey,, (DIR) @top VIP +@insertcopying + VIP is a Vi emulating package written in Emacs Lisp. VIP implements most Vi commands including Ex commands. It is therefore hoped that this package will enable you to do Vi style editing under the powerful GNU Emacs Index: viper.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/viper.texi,v retrieving revision 1.10 diff -u -r1.10 viper.texi --- viper.texi 8 Jan 2009 05:29:14 -0000 1.10 +++ viper.texi 8 Feb 2009 19:29:43 -0000 @@ -52,6 +52,8 @@ @unnumbered Viper +@insertcopying + We believe that one or more of the following statements are adequate descriptions of Viper: Index: widget.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/widget.texi,v retrieving revision 1.8 diff -u -r1.8 widget.texi --- widget.texi 8 Jan 2009 05:29:14 -0000 1.8 +++ widget.texi 8 Feb 2009 19:29:54 -0000 @@ -37,6 +37,8 @@ @comment node-name, next, previous, up @top The Emacs Widget Library +@insertcopying + @menu * Introduction:: * User Interface:: Index: woman.texi =================================================================== RCS file: /sources/emacs/emacs/doc/misc/woman.texi,v retrieving revision 1.8 diff -u -r1.8 woman.texi --- woman.texi 8 Jan 2009 05:29:15 -0000 1.8 +++ woman.texi 8 Feb 2009 19:30:05 -0000 @@ -73,6 +73,8 @@ @comment node-name, next, previous, up @top WoMan: Browse Unix Manual Pages ``W.O. (without) Man'' +@insertcopying + @display Software Version @value{VERSION} Manual Last Updated @value{UPDATED} [-- Attachment #3: Type: text/plain, Size: 298 bytes --] > Dealing with manuals in other distributions has to be done separately, > through their respective maintainers/bug lists. If you want to take > that on, that would be great. OK, I'll see what I can do. Do you have any suggestions about which projects would be most receptive? Jesse Weinstein ^ permalink raw reply [flat|nested] 17+ messages in thread
* bug#1988: Making the license statement visible in the Emacs Manual 2009-02-08 19:38 ` Jesse W @ 2009-02-16 17:50 ` Karl Berry 0 siblings, 0 replies; 17+ messages in thread From: Karl Berry @ 2009-02-16 17:50 UTC (permalink / raw) To: jessw; +Cc: 1988 And that's it... all the others are included in the big-pile-o-patch attached below. Thanks. I finally made the changes, inserting some @ifnottex's, consistently putting the @insertcopying at the end of the Top node, etc. While I was at it, I made the @contents and @direntry usage consistent too. Do you have any suggestions about which projects would be most receptive? I expect any project will be receptive if you send an actual patch. I've sent a lot of patches to a lot of Texinfo manuals over the years and they've never been anything but gratefully received :). ^ permalink raw reply [flat|nested] 17+ messages in thread
end of thread, other threads:[~2009-02-16 17:50 UTC | newest] Thread overview: 17+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2009-01-22 8:16 bug#1988: Making the license statement visible in the Emacs Manual Jesse W 2009-01-26 7:38 ` Glenn Morris 2009-01-26 18:33 ` Jesse W 2009-01-26 18:41 ` Glenn Morris 2009-01-26 21:28 ` Jesse W 2009-01-26 22:45 ` Eli Zaretskii 2009-01-27 22:59 ` Richard M Stallman 2009-01-28 4:04 ` Eli Zaretskii 2009-01-28 23:38 ` Karl Berry 2009-01-29 0:25 ` Jesse W 2009-02-01 14:37 ` Karl Berry 2009-02-05 9:29 ` Jesse W 2009-02-06 0:05 ` Karl Berry 2009-02-06 19:03 ` Jesse W 2009-02-06 23:02 ` Karl Berry 2009-02-08 19:38 ` Jesse W 2009-02-16 17:50 ` Karl Berry
Code repositories for project(s) associated with this external index https://git.savannah.gnu.org/cgit/emacs.git https://git.savannah.gnu.org/cgit/emacs/org-mode.git This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.