From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 2267 invoked from network); 26 Nov 2004 10:17:53 +0000 Received: from smtp.gentoo.org (156.56.111.197) by lists.gentoo.org with AES256-SHA encrypted SMTP; 26 Nov 2004 10:17:53 +0000 Received: from lists.gentoo.org ([156.56.111.196] helo=parrot.gentoo.org) by smtp.gentoo.org with esmtp (Exim 4.41) id 1CXdAn-0001sp-1T for arch-gentoo-dev@lists.gentoo.org; Fri, 26 Nov 2004 10:17:53 +0000 Received: (qmail 7341 invoked by uid 89); 26 Nov 2004 10:17:52 +0000 Mailing-List: contact gentoo-dev-help@gentoo.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Received: (qmail 20404 invoked from network); 26 Nov 2004 10:17:52 +0000 Date: Fri, 26 Nov 2004 10:17:34 +0000 From: Ciaran McCreesh To: gentoo-dev@lists.gentoo.org Message-ID: <20041126101734.59070a9a@snowdrop.home> In-Reply-To: <20041126022509.GA26935@ols-dell.iic.hokudai.ac.jp> References: <200411222345.14487.vapier@gentoo.org> <3908185A3D2C144E9FAD070D2727FFD81716A9@PERIMAIL.perimed.priv> <921ad39e04112306381595bc8a@mail.gmail.com> <1049C878-3D68-11D9-9250-000A958238BC@gentoo.org> <1101226835.9000.39.camel@cgianelloni.nuvox.net> <46059ce104112315265d557064@mail.gmail.com> <1101327015.9848.5.camel@io> <20041125094444.GA13530@lion.gg3.net> <20041126022509.GA26935@ols-dell.iic.hokudai.ac.jp> X-Mailer: Sylpheed-Claws 0.9.12b (GTK+ 1.2.10; i686-pc-linux-gnu) Mime-Version: 1.0 Content-Type: multipart/signed; protocol="application/pgp-signature"; micalg="pgp-sha1"; boundary="Signature=_Fri__26_Nov_2004_10_17_34_+0000__=6+_LpjF5j2/937" Subject: Re: [gentoo-dev] Gentoo beeping at me! X-Archives-Salt: 22c0df6e-6403-4408-91c0-15385bc63fdf X-Archives-Hash: cefecf992ceb700a285fcd8316f0f582 --Signature=_Fri__26_Nov_2004_10_17_34_+0000__=6+_LpjF5j2/937 Content-Type: text/plain; charset=US-ASCII Content-Disposition: inline Content-Transfer-Encoding: 7bit On Fri, 26 Nov 2004 11:25:10 +0900 Georgi Georgiev wrote: | maillog: 25/11/2004-19:19:27(+0000): Ed Grimm types | > On Thu, 25 Nov 2004, Georgi Georgiev wrote: | > | > If you really think that in-line docs are ugly, use vim(1), and | > automagically fold them out of your view (:help foldexpr, although | > this can be set to happen in the eclass syntax file). I suspect | > that most of the people who only occasionally work with the | > eclasses, and those who are just starting to use the eclasses, would | > find them more useful than ugly. | | I have nothing against in-line docs in general. I simply had trouble | imagining it in the bash case. | | What about using perldoc itself? Simply prepend every doc line with a | '#', then run | | awk '/^#/ { sub("#",""); print } In bash? How would that work? Here's another possibility: # {{{ doc # whatever format we decide upon # blah blah blah # }}} Doesn't screw up normal comments, really easy to find and process, easy to turn into folds in the editor :) -- Ciaran McCreesh : Gentoo Developer (Vim, Fluxbox, Sparc, Mips) Mail : ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm --Signature=_Fri__26_Nov_2004_10_17_34_+0000__=6+_LpjF5j2/937 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (GNU/Linux) iD8DBQFBpwLA96zL6DUtXhERAqACAJ0aNil98o02JfsTmWNp7CXJIePGjwCeOZUM 7U0rzY8KRDs1JJMya7qMwZk= =l+zY -----END PGP SIGNATURE----- --Signature=_Fri__26_Nov_2004_10_17_34_+0000__=6+_LpjF5j2/937--