From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 2228 invoked by alias); 19 Feb 2002 22:37:56 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 2164 invoked from network); 19 Feb 2002 22:37:53 -0000 Received: from unknown (HELO localhost.redhat.com) (216.138.202.10) by sources.redhat.com with SMTP; 19 Feb 2002 22:37:53 -0000 Received: from cygnus.com (localhost [127.0.0.1]) by localhost.redhat.com (Postfix) with ESMTP id 15D053D12; Tue, 19 Feb 2002 17:37:53 -0500 (EST) Message-ID: <3C72D3C0.9080508@cygnus.com> Date: Tue, 19 Feb 2002 14:37:00 -0000 From: Andrew Cagney User-Agent: Mozilla/5.0 (X11; U; NetBSD macppc; en-US; rv:0.9.8) Gecko/20020210 X-Accept-Language: en-us MIME-Version: 1.0 To: Eli Zaretskii Cc: muller@cerbere.u-strasbg.fr, gdb-patches@sources.redhat.com Subject: Re: [RFC] document Cygwin native specific commands References: <4.2.0.58.20020219102752.0248dc18@ics.u-strasbg.fr> <4760-Tue19Feb2002152216+0200-eliz@is.elta.co.il> <3C727F4F.5020100@cygnus.com> <563-Tue19Feb2002192641+0200-eliz@is.elta.co.il> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-SW-Source: 2002-02/txt/msg00509.txt.bz2 > Date: Tue, 19 Feb 2002 11:37:35 -0500 >> From: Andrew Cagney >> >> Hmm. Given a dump of all of GDB's commands, should there be a kindex >> for each? > > > Yes, each command described in the manual should be indexed. That > way, all users need to type to find the documentation of any given > command CMD is "i CMD ", once they are in an Info reader. > > The issue of undocumented commands came up several times in the past, > with Stan reminding us, time and again, a threat to remove any > undocumented commands from the code ;-) I've now got something tangable to work with ... >> What about the reverse? > > > I don't understand the question, sorry. Should, for every @kindex, there be a corresponding command? I suspect this is half correct. A quick grep came up with things like ``@kindex PageUp''. So that not only undocumented commands but also commands that have been removed can be detected - remember the discovery MichaelS made with >> I think we might have just stumbled across something that is feasible >> for the ARI to check. > > > A good idea, IMHO. Perhaps it could also comment out any command > that doesn't have documentation ;-) How about I make them disabled but allow the user to re-enable them once the've entered documentation at a prompt? :-) Andrew