[RFA/doco] Update copyright year in refcard

[RFA/doco] Update copyright year in refcard

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 592 bytes --]

This one is a little less obvious: doc/refcard.tex.

The header is easy, I just added 2010.  The text, however, does not
use spaces after the comma when specifying the copyright years.
I followed the current usage for now, but I can certainly add spaces.
I wonder if we might simply want to use year range, eg 2000-2010.
We have forgotten to update this file for years, hence the missing
years in the text...

2010-01-01  Joel Brobecker  <brobecker@adacore.com>

        * refcard.tex: Update copyright year in header and text.

Tested by rebuilding the PDF and HTML documentation.

-- 
Joel

[-- Attachment #2: refcard.diff --]
[-- Type: text/x-diff, Size: 1637 bytes --]

commit 6dd6e8c396a1ba8d0a8c39db8bde48ae8c4990f6
Author: Joel Brobecker <brobecker@adacore.com>
Date:   Fri Jan 1 13:12:35 2010 +0400

    Update copyright year list in refcard.tex.
    
            * refcard.tex: Update copyright year in header and text.

diff --git a/gdb/doc/refcard.tex b/gdb/doc/refcard.tex
index 6d48302..7f77d11 100644
--- a/gdb/doc/refcard.tex
+++ b/gdb/doc/refcard.tex
@@ -1,7 +1,7 @@
 %%%%%%%%%%%%%%%% gdb-refcard.tex %%%%%%%%%%%%%%%%
 
 %This file is TeX source for a reference card describing GDB, the GNU debugger.
-%Copyright (C) 1991, 1992, 1993, 1996, 1998, 1999, 2000, 2007
+%Copyright (C) 1991, 1992, 1993, 1996, 1998, 1999, 2000, 2007, 2010
 %Free Software Foundation, Inc.
 %Permission is granted to make and distribute verbatim copies of
 %this reference provided the copyright notices and permission notices
@@ -309,7 +309,7 @@ shell {\it cmd}&execute arbitrary shell command string\cr
 \line{\smrm \opt{ } surround optional arguments \hfill $\ldots$ show
 one or more arguments}
 \vskip\baselineskip
-\centerline{\smrm \copyright 1998,2000 Free Software Foundation, Inc.\qquad Permissions on back}
+\centerline{\smrm \copyright 1998,2000,2010 Free Software Foundation, Inc.\qquad Permissions on back}
 \eject
 \sec Breakpoints and Watchpoints;
 break \opt{\it file\tt:}{\it line}\par
@@ -633,7 +633,7 @@ statement.\cr
 
 \vfill
 {\smrm\parskip=6pt
-Copyright \copyright 1991,'92,'93,'98,2000 Free Software Foundation, Inc. 
+Copyright \copyright 1991,'92,'93,'98,2000,2010 Free Software Foundation, Inc. 
 Author: Roland H. Pesch
 
 The author assumes no responsibility for any errors on this card.

Re: [RFA/doco] Update copyright year in refcard

[Eli Zaretskii]

> Date: Fri, 1 Jan 2010 13:18:18 +0400
> From: Joel Brobecker <brobecker@adacore.com>
> 
> This one is a little less obvious: doc/refcard.tex.

Approved, thanks.

> The header is easy, I just added 2010.  The text, however, does not
> use spaces after the comma when specifying the copyright years.
> I followed the current usage for now, but I can certainly add spaces.

It's a matter of style.  I like the spaces better, so if you have a
moment to spare, please go ahead.

> I wonder if we might simply want to use year range, eg 2000-2010.

No, that was voted down by FSF lawyers at some point.  IANAL, so I
don't know the details, only that RMS told a few years ago that each
year needs to be spelled out.

> We have forgotten to update this file for years, hence the missing
> years in the text...

I think we should add them now.  It is okay fixing a mistake such as
this one; leaving the mistake alone is not a good idea, because it
makes the file unprotected for the years when it was actually
maintained.

Re: [RFA/doco] Update copyright year in refcard

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 2172 bytes --]

> > The header is easy, I just added 2010.  The text, however, does not
> > use spaces after the comma when specifying the copyright years.
> > I followed the current usage for now, but I can certainly add spaces.
> 
> It's a matter of style.  I like the spaces better, so if you have a
> moment to spare, please go ahead.

OK. Since I'm modifying the file, it was no problem adding the spaces.
I also change the '92 into 1992. Attached is what I checked in for now.

> No, that was voted down by FSF lawyers at some point.  IANAL, so I
> don't know the details, only that RMS told a few years ago that each
> year needs to be spelled out.

OK. I don't mind that for the copyright headers.  That still leaves me
wondering what should be done for the copyright notice in manuals, or
the copyright year printed by GDB, gdbserver, etc. I believe that GDB
does the right thing, and just prints the current year.  It is not
so bad if it's a few years, but it looks a bit silly when the list
spans an entirely line or more... I looked at a few manuals,
particularly the ones that got reprinted, and they seem to follow
a convention where the print one line per reprint, something like:

    (c) 2004 This Press Ltd
    (c) 2006 This Press Ltd
    (c) 2008 A Better Press And Sons Ltd

I'm happy to follow whatever the FSF dictates, but it would be nice
if we could simply have just the current year in our manuals.

> I think we should add them now.  It is okay fixing a mistake such as
> this one; leaving the mistake alone is not a good idea, because it
> makes the file unprotected for the years when it was actually
> maintained.

According to Robert Dewar, who is not a lawyer, headers such as these
are not legally significant. So I don't think we need to worry about
this too much.  But I also think we should fix them whereever we see
an error and we're sure. So I've added 2007/8/9 to the refcard, for
instance. I'm pretty sure for some years before that, but up to when?
I would need to verify in our CVS which, I have to confess, isn't
very appealing at the moment (I've done my share of paperwork for today).

Thanks a lot for the review and the feedback.

-- 
Joel

[-- Attachment #2: refcard.diff --]
[-- Type: text/x-diff, Size: 1588 bytes --]

Index: refcard.tex
===================================================================
RCS file: /cvs/src/src/gdb/doc/refcard.tex,v
retrieving revision 1.6
diff -u -p -r1.6 refcard.tex
--- refcard.tex	27 Mar 2007 18:09:35 -0000	1.6
+++ refcard.tex	1 Jan 2010 11:15:31 -0000
@@ -1,8 +1,8 @@
 %%%%%%%%%%%%%%%% gdb-refcard.tex %%%%%%%%%%%%%%%%
 
 %This file is TeX source for a reference card describing GDB, the GNU debugger.
-%Copyright (C) 1991, 1992, 1993, 1996, 1998, 1999, 2000, 2007
-%Free Software Foundation, Inc.
+%Copyright (C) 1991, 1992, 1993, 1996, 1998, 1999, 2000, 2007, 2008,
+%2009, 2010 Free Software Foundation, Inc.
 %Permission is granted to make and distribute verbatim copies of
 %this reference provided the copyright notices and permission notices
 %are preserved on all copies.
@@ -309,7 +309,7 @@ shell {\it cmd}&execute arbitrary shell 
 \line{\smrm \opt{ } surround optional arguments \hfill $\ldots$ show
 one or more arguments}
 \vskip\baselineskip
-\centerline{\smrm \copyright 1998,2000 Free Software Foundation, Inc.\qquad Permissions on back}
+\centerline{\smrm \copyright 1998, 2000, 2010 Free Software Foundation, Inc.\qquad Permissions on back}
 \eject
 \sec Breakpoints and Watchpoints;
 break \opt{\it file\tt:}{\it line}\par
@@ -633,7 +633,7 @@ statement.\cr 
 
 \vfill
 {\smrm\parskip=6pt
-Copyright \copyright 1991,'92,'93,'98,2000 Free Software Foundation, Inc. 
+Copyright \copyright 1991, 1992, 1993, 1998, 2000, 2010 Free Software Foundation, Inc. 
 Author: Roland H. Pesch
 
 The author assumes no responsibility for any errors on this card.

Re: [RFA/doco] Update copyright year in refcard

[Eli Zaretskii]

> Date: Fri, 1 Jan 2010 15:30:41 +0400
> From: Joel Brobecker <brobecker@adacore.com>
> Cc: gdb-patches@sourceware.org
> 
> That still leaves me
> wondering what should be done for the copyright notice in manuals, or
> the copyright year printed by GDB, gdbserver, etc. I believe that GDB
> does the right thing, and just prints the current year.  It is not
> so bad if it's a few years, but it looks a bit silly when the list
> spans an entirely line or more... I looked at a few manuals,
> particularly the ones that got reprinted, and they seem to follow
> a convention where the print one line per reprint, something like:
> 
>     (c) 2004 This Press Ltd
>     (c) 2006 This Press Ltd
>     (c) 2008 A Better Press And Sons Ltd
> 
> I'm happy to follow whatever the FSF dictates, but it would be nice
> if we could simply have just the current year in our manuals.

The year in the printed manual is a separate issue.  I don't know
about that, I think we should ask if we are unsure.

I was talking only about copyright notices on files we distribute, be
it part of the manual sources, the GDB sources, or whatever.