From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26472 invoked from network); 26 Nov 2004 18:04:05 +0000 Received: from smtp.gentoo.org (156.56.111.197) by lists.gentoo.org with AES256-SHA encrypted SMTP; 26 Nov 2004 18:04:05 +0000 Received: from lists.gentoo.org ([156.56.111.196] helo=parrot.gentoo.org) by smtp.gentoo.org with esmtp (Exim 4.41) id 1CXkRx-00075r-LF for arch-gentoo-dev@lists.gentoo.org; Fri, 26 Nov 2004 18:04:05 +0000 Received: (qmail 3379 invoked by uid 89); 26 Nov 2004 18:04:05 +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 25140 invoked from network); 26 Nov 2004 18:04:04 +0000 Date: Sat, 27 Nov 2004 03:03:52 +0900 From: Georgi Georgiev To: gentoo-dev@lists.gentoo.org Message-ID: <20041126180351.GA11093@lion.gg3.net> Mail-Followup-To: gentoo-dev@lists.gentoo.org References: <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> <20041126101734.59070a9a@snowdrop.home> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="cWoXeonUoKmBZSoM" Content-Disposition: inline In-Reply-To: <20041126101734.59070a9a@snowdrop.home> User-Agent: Mutt/1.5.6i Subject: Re: [gentoo-dev] Gentoo beeping at me! X-Archives-Salt: c21a46e9-f106-4337-8bce-902781a57d71 X-Archives-Hash: c9b0d3e8ac00e4f5fe1b13e01aa97a83 --cWoXeonUoKmBZSoM Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable maillog: 26/11/2004-10:17:34(+0000): Ciaran McCreesh types > 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: > | >=20 > | > 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. > |=20 > | I have nothing against in-line docs in general. I simply had trouble > | imagining it in the bash case. > |=20 > | What about using perldoc itself? Simply prepend every doc line with a > | '#', then run > |=20 > | awk '/^#/ { sub("#",""); print } >=20 > In bash? How would that work? I imagined #=3Ditem blah blah # more POD # and more # and more #=3Dcut > Here's another possibility: >=20 > # {{{ doc > # whatever format we decide upon > # blah blah blah > # }}} >=20 > Doesn't screw up normal comments, really easy to find and process, easy > to turn into folds in the editor :) Sounds great. Now all that's left is to agree upon the format and write the converter. Oh, and my favorite -- a GLEP maybe? (no, I'm not sarcastic; just in a good mood ;) ). --=20 ) Georgi Georgiev ) Hi! I'm Larry. This is my brother Bob, and ) ( chutz@gg3.net ( this is my other brother Jimbo. We thought ( ) +81(90)6266-1163 ) you might like to know the names of your ) ( ------------------- ( assailants. ( --cWoXeonUoKmBZSoM Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (GNU/Linux) iD8DBQFBp3AHfXO2NUT1EmYRAqN/AKDvbuu5qy+nB4axF33BDf24rg/4RgCgpu7H 3PwdTTLH/wzPlwEXs52G7+Y= =oBaQ -----END PGP SIGNATURE----- --cWoXeonUoKmBZSoM--