From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29556 invoked by alias); 28 Mar 2002 09:24:34 -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 29538 invoked from network); 28 Mar 2002 09:24:30 -0000 Received: from unknown (HELO mirapoint.inter.net.il) (192.114.186.20) by sources.redhat.com with SMTP; 28 Mar 2002 09:24:30 -0000 Received: from zaretsky (diup-217-212.inter.net.il [213.8.217.212]) by mirapoint.inter.net.il (Mirapoint Messaging Server MOS 2.9.3.2) with ESMTP id AAH71754; Thu, 28 Mar 2002 11:24:23 +0200 (IST) Date: Thu, 28 Mar 2002 01:24:00 -0000 From: "Eli Zaretskii" To: ac131313@cygnus.com Message-Id: <2593-Thu28Mar2002112045+0200-eliz@is.elta.co.il> CC: msnyder@cygnus.com, gdb-patches@sources.redhat.com In-reply-to: <3CA2762E.6030009@cygnus.com> (message from Andrew Cagney on Wed, 27 Mar 2002 20:47:26 -0500) Subject: Re: [RFA] New commands, dump/restore memory<-->file Reply-to: Eli Zaretskii References: <3CA237BC.F1019319@redhat.com> <3CA23CF9.8090601@cygnus.com> <3CA26AB5.C6940728@redhat.com> <3CA2762E.6030009@cygnus.com> X-SW-Source: 2002-03/txt/msg00581.txt.bz2 > Date: Wed, 27 Mar 2002 20:47:26 -0500 > From: Andrew Cagney > > That is why I was suggesting an advanced features section to put things > like this in. If there's unhappiness with the current structure of the manual (which is indeed a bit too shallow), I can think about grouping the material differently, to make it deeper and with less top-level chapters. However, a single chapter named "Advanced Features" is hardly any help in this direction, since its name doesn't say anything about what's in it, and so cannot help in locating material. > The main thing though is a good tutorial/example so > people know how to string the commands together to do something useful :-) I agree wholeheartedly that having more tutorial-level information would be great. Perhaps we should at least consider requesting a couple of non-trivial examples with each command whose documentation is submitted for approval.