From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Daniel Colascione Newsgroups: gmane.emacs.devel Subject: Re: Dynamic loading progress Date: Mon, 28 Sep 2015 12:41:17 -0700 Message-ID: <560997DD.9090509@dancol.org> References: <55F5DD8C.70506@dancol.org> <55F62C16.4000105@dancol.org> <55F64F04.9030002@dancol.org> <55F6E43E.9030502@dancol.org> <55F70C4E.8030805@dancol.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="VtkO3MBQ1NkB4Oc4wc43FVX8bdLIrNxbT" X-Trace: ger.gmane.org 1443489002 3215 80.91.229.3 (29 Sep 2015 01:10:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 29 Sep 2015 01:10:02 +0000 (UTC) Cc: =?UTF-8?Q?Aur=c3=a9lien_Aptel?= , Stephen Leake , Paul Eggert , Tom Tromey , Emacs development discussions To: Stefan Monnier , Philipp Stephani Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 29 03:09:51 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZgjQV-0007z8-0I for ged-emacs-devel@m.gmane.org; Tue, 29 Sep 2015 03:09:51 +0200 Original-Received: from localhost ([::1]:43483 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZgjQU-0001QN-Bc for ged-emacs-devel@m.gmane.org; Mon, 28 Sep 2015 21:09:50 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47484) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZgeIo-0006zu-Fa for emacs-devel@gnu.org; Mon, 28 Sep 2015 15:41:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZgeIk-0007UZ-L2 for emacs-devel@gnu.org; Mon, 28 Sep 2015 15:41:34 -0400 Original-Received: from dancol.org ([2600:3c01::f03c:91ff:fedf:adf3]:35021) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZgeIk-0007UL-CL for emacs-devel@gnu.org; Mon, 28 Sep 2015 15:41:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=dancol.org; s=x; h=Content-Type:In-Reply-To:MIME-Version:Date:Message-ID:From:Cc:References:To:Subject; bh=+Km/dJjzzc4o4ekpfzMmF+b36UD9akrvmk492JcnYAs=; b=ShNWTR2ZLwcpkRsX6tIbEkcj6Ph1j206Esw/YAZ2xglsOclPInto51I+sF6SpkeebFFjZ8KyuFmPFYzzXzncXboGS5j9/4pHuNHWmjhi3+XIUTFm8s7Xf0yIe9PaR3HDnMlj2j00wVMdTcht1Ov6AldQesT8ThJxCcOJ1OWZ/FL1J+lQmTYx0yn8F9U6HQ3wqdGcv0X41XWT5QFhskIKiZVub3QuIcskUWiymw771AWB0RqgkDQJ856/WRGU2goYgFY1MBj3hIuToZJW/SnuAV1NHw3scmpMp95fc8k2CBlWAJs7yWeZxeRD+lWmYczJDlejntl8/CCXPLwIFCiu1w==; Original-Received: from c-24-16-208-239.hsd1.wa.comcast.net ([24.16.208.239] helo=[192.168.1.210]) by dancol.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84) (envelope-from ) id 1ZgeIb-00069E-SK; Mon, 28 Sep 2015 12:41:21 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.2.0 In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2600:3c01::f03c:91ff:fedf:adf3 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:190461 Archived-At: This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --VtkO3MBQ1NkB4Oc4wc43FVX8bdLIrNxbT Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable On 09/28/2015 12:39 PM, Stefan Monnier wrote: >> There are some documentation frameworks available, e.g. Doxygen. >> It might be a good idea to use one of them instead of trying to define= >> your own syntax. >=20 > Using doxygen sounds like a good idea. >=20 > Since the only thing we really need to formalize is the place and forma= t > of the "compiled" docstrings (e.g. "a DOC file"), there could even be > several tools available which allow placing the docstring in various > ways in the source code. And each module could use the tool it prefers= =2E Do we even need this optimization in the modern world? Life would be simpler if we could just get rid of the lazy-loaded documentation string machinery. --VtkO3MBQ1NkB4Oc4wc43FVX8bdLIrNxbT Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIcBAEBCAAGBQJWCZfdAAoJEN4WImmbpWBl3U8P/Rx4AyRKfGNl4vuAZkFgBq4T bijLtf2BrljMmOwHvbeimMTEgZVkOxF1sSSf5r1w58JKtTRslrhVsvEuHdBAC17Z rc8t3yMMB+0lAt9ACiE1n+aTsgksLIFw0wgFz9Gz+i3aOt91DZCVTT7tEN140+jU b8EM4cPo9GYJHweb8y1wtzwELFn6fo5d0yyr3pHYehNQIdjGQGb1gK9IFu5gKU+D f4d+Gz6vQ5cTc+vuxiFW2KxO5+HB76BGKJTxPnUR527RbdfceFtPKrPNohUDLLoX P1ZoZ6ZB70rSPidxJLyf4gdNeFdwpERUjABWAZsJ4IyqLxoeobbA+ZkwJsxQf45b XXUBdR8pSz4BzuZXMCgNdjVT6pldslOrcGLv5Or6VSfIck3DzSd8i/LISBcBPKmr CU+uWAew4kiTOyCUtO7pGpzIoIGce8LuJHPsRzwv7mqljtkYlAG916Ml4IfNUBU7 VycRTUFAWdHFkp7ItL1mTRZFTCodEbj7YsYQmaCN5TMXKgVpdhcUolKCEGFRlmnV EIfdJPJkDy1x/MqJ8rTonwW+kOytzDzOkSzdQ8psp9/0FDDfLQBvNMuc82SfBi52 OLK2jYmKdPQfZ++Fxz2Hczg4ugrr5JivUm6E9/RvbDWjm09s6uKXRV/Q7Ft7ncmw lD6SkMGvJFVccPyglvuh =VbVE -----END PGP SIGNATURE----- --VtkO3MBQ1NkB4Oc4wc43FVX8bdLIrNxbT--