Re: multiple @syntax

[Tom Howard]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi,

Guido Draheim wrote:
> Next question, how about the "obsoletion" mark - we had that a few
> days ago - the gnu ac-archive oes currently contains 16 macros with
> my old style of "dnl obsoleted" attribution. Do we use "@obsoleted"
> next (as is my preference), keep with the in-document syntax, or
> add it to the list of @category attributions (adding up to the
> main category)

I propose we remove the obsoleted tag and add the following macro

AX_OBSOLETE([MACRO_NAME],[WHEN],[DETAILS],[REPLACEMENT])

which prints out to the user that the macro is obsolete, when it was
made obsolete and if specified the details and it's replacement.  The
doc generator would need to be modified to pick this up, but other that
that, what do you think?

> Next question, how about an "experimental" mark - so these macros
> can be displayed as secondary on the website - just add to the
> @category listing? I might prefer another @experimental [hint]
> notion here which has a freeform hint even that it is usually
> pointing to the source - author or project most of the times.

How about

AX_EXPERIMENTAL([MACRO_NAME],[DETAILS])

Cheers,

- --
Tom Howard

Public Key: http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x433B299A
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (MingW32)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFB9Dskw1G4ZUM7KZoRAibwAJ4yFGWpwzMO2mJneNE07+NwAr/cZgCgvYX0
+ydc1aqMjInHa5AzLxdiIEo=
=fmWk
-----END PGP SIGNATURE-----

tomhoward.vcf
Description: Vcard