From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-69190-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 30288 invoked by alias); 1 Jan 2010 10:42:49 -0000
Received: (qmail 30278 invoked by uid 22791); 1 Jan 2010 10:42:47 -0000
X-SWARE-Spam-Status: No, hits=0.5 required=5.0 	tests=AWL,BAYES_00,FH_DATE_PAST_20XX,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout20.012.net.il (HELO mtaout20.012.net.il) (80.179.55.166)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 01 Jan 2010 10:42:42 +0000
Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0KVK00300DLRLO00@a-mtaout20.012.net.il> for gdb-patches@sourceware.org; Fri, 01 Jan 2010 12:41:57 +0200 (IST)
Received: from HOME-C4E4A596F7 ([77.127.222.44]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KVK00MOEDPXOVC0@a-mtaout20.012.net.il>; Fri, 01 Jan 2010 12:41:57 +0200 (IST)
Date: Fri, 01 Jan 2010 10:42:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: [RFA/doco] Update the "Start of New Year Procedure"
In-reply-to: <20100101091009.GI548@adacore.com>
To: Joel Brobecker <brobecker@adacore.com>
Cc: gdb-patches@sourceware.org
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <83eimaf6k7.fsf@gnu.org>
References: <20100101091009.GI548@adacore.com>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2010-01/txt/msg00014.txt.bz2

> Date: Fri, 1 Jan 2010 13:10:09 +0400
> From: Joel Brobecker <brobecker@adacore.com>
> 
> I would like to clarify a little bit the process needed to update
> the copyright headers. Patch attached.

Thanks.

> +Run the @code{copyright.sh} script to add the new year in the copyright
> +notices of most source files.  This script requires Emacs 22 or later to
> +be installed.

It's better to put copyright.sh in @file, not in @code.

> +@itemize @bullet
> +  @item @file{*.s}
> +  @item @file{*.f}
> +  @item @file{*.f90}
> +  @item @file{*.igen}
> +  @item @file{*.ac}
> +  @item @file{*.texi}
> +  @item @file{*.texinfo}
> +  @item @file{*.tex}
> +  @item @file{*.defs}
> +  @item @file{*.1}
> +@end itemize

Although this format is permitted, the canonical way of writing an
itemized list is to have @item on its own line:

  @item
  @file{*.s}
  @item
  @file {*.f}
  ...

Did you have a good reason for not using the canonical form?  If not,
I'd prefer to use it, although I won't object to what you did as well.

Also, perhaps it is worthwhile to spell out the language for each file
type.  Again, that's not a blocking comment.

Otherwise, okay with me.