unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Excess spaces in info copyrights; inconsistent @copyright{} usage.
@ 2006-03-07 17:28 Andrew M. Scott
  2006-03-09  3:06 ` Michael Olson
  0 siblings, 1 reply; 3+ messages in thread
From: Andrew M. Scott @ 2006-03-07 17:28 UTC (permalink / raw)


I noticed two anomalies in the current info/texi files:

1. There are excess spaces in the generated Copyright lines in many
   but not all info files; I'm using makeinfo 4.8. This seems to occur
   for files with more than one line of copyright dates.

2. Some of the *.texi files use the @copyright{} construct in their
   copyright lines (e.g. erc.texi), and some don't (e.g. elisp.texi).

Samples:

A. elisp.info snippet:

   This is edition 2.9 of the GNU Emacs Lisp Reference Manual,
corresponding to Emacs version 22.0.50.

   Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999,
2000,   2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
     ^^^

here is the corresponding snippet from elisp.texi:

Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000,
  2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.

A quick spot-check showed similar excess spaces in the info files for
eshell, woman, and ebrowse, but *not* pcl-cvs or message.

B. The space in url.info appears to be due to hard spaces in the
   url.texi file.

C. The erc.texi file is an example of a file using the @copyright{}
   construct (in constrast to elisp.texi):

This manual is for ERC version 5.1.2.

Copyright @copyright{} 2005, 2006 Free Software Foundation, Inc.


In GNU Emacs 22.0.50.1 (x86_64-unknown-linux-gnu, X toolkit)
 of 2006-03-07 on chls308

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: C
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8
  default-enable-multibyte-characters: t

Andy Scott

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Excess spaces in info copyrights; inconsistent @copyright{} usage.
  2006-03-07 17:28 Excess spaces in info copyrights; inconsistent @copyright{} usage Andrew M. Scott
@ 2006-03-09  3:06 ` Michael Olson
  0 siblings, 0 replies; 3+ messages in thread
From: Michael Olson @ 2006-03-09  3:06 UTC (permalink / raw)



[-- Attachment #1.1: Type: text/plain, Size: 899 bytes --]

"Andrew M. Scott" <amscott1@sedona.ch.intel.com> writes:

> I noticed two anomalies in the current info/texi files:
>
> 1. There are excess spaces in the generated Copyright lines in many
> but not all info files; I'm using makeinfo 4.8. This seems to occur
> for files with more than one line of copyright dates.
>
> 2. Some of the *.texi files use the @copyright{} construct in their
> copyright lines (e.g. erc.texi), and some don't (e.g. elisp.texi).

I used @copyright{} in erc.texi because it is used in Section 3.3.1 in
the Texinfo manual.  If this is incorrect, the Texinfo manual should
be updated to that effect.

-- 
Michael Olson -- FSF Associate Member #652 -- http://www.mwolson.org/
Interests: Emacs Lisp, text markup, IRC, EMMS, anime, manga, Debian
  /` |\ | | | IRC: mwolson on freenode.net: #hcoop, #muse, #PurdueLUG
 |_] | \| |_| Jabber: mwolson_at_hcoop.net

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Excess spaces in info copyrights; inconsistent @copyright{} usage.
@ 2006-03-25 23:27 Karl Berry
  0 siblings, 0 replies; 3+ messages in thread
From: Karl Berry @ 2006-03-25 23:27 UTC (permalink / raw)


Hi Andrew and all,

    1. There are excess spaces in the generated Copyright lines in many
       but not all info files; I'm using makeinfo 4.8. This seems to occur
       for files with more than one line of copyright dates.

In general, makeinfo (unlike TeX) does not ignore spaces at the
beginning of a line.  Most multiple-line copyrights were indeed indented
in the source:
Copyright ...
  2000, 2001 ...

The two spaces in the input are preserved in the makeinfo output, a
"feature" of makeinfo since inception.  (Probably inherited from
texinfo-format-buffer, I expect.)

Anyway, I removed all such indentations I could find in the Emacs manual
sources, and added an admonition about it in the Texinfo manual.

    2. Some of the *.texi files use the @copyright{} construct in their
       copyright lines (e.g. erc.texi), and some don't (e.g. elisp.texi).

@copyright{} should be used within an @copying block or similar.  Again,
I changed all the occurrences I could find.  (The exception are the @c
copyrights in the subsidiary .texi files; since that text is never
typeset, (C) is preferred there.)

A few manuals still used @ifinfo and the like instead of @copying (also,
@ifnottex should be used around the Top node).  If someone else could
systematically check for and fix that problem, I would be grateful.

Thanks for the report,
Karl

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2006-03-25 23:27 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-03-07 17:28 Excess spaces in info copyrights; inconsistent @copyright{} usage Andrew M. Scott
2006-03-09  3:06 ` Michael Olson
  -- strict thread matches above, loose matches on Subject: below --
2006-03-25 23:27 Karl Berry

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).