This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Re: methodsynopsisinfo tag?


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

On Monday 17 February 2003 06:41 pm, Norman Walsh wrote:
> / Alex Russell <alex@netwindows.org> was heard to say:
> [...]
>
> Have you considered simply moving the methodsynopsis out of the
> classsynopsis, at least for the purposes of larger description?

I'd considered it, but it seems a bit cumbersome and doesn't "feel right" to 
me, espically given the presence of a functionsynopsisinfo tag which 
essentially fills my needs. It seems kind of inconsistent not to include a 
similar descriptive capability for a callable entry point simply because it 
has the context of a class and not the top-level namespace..

> You could even make the methodsynopsis a link back to some
> classsynopsis overview at the top of the document, with a little
> effort.

I think for now that's what we'll do, although I still consider the lack of 
a methodsynopsisinfo tag to be an omission (if only for the sake of 
consistency). 

Thanks.

- -- 
Alex Russell
alex@netWindows.org
alex@SecurePipe.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)

iD8DBQE+UDm+oV0dQ6uSmkYRAh1GAKCf5iFE7CLwiZqWVwh3jhxvyShoewCgt9AO
ZllGetGuSNJoboPILaXRma0=
=2wwj
-----END PGP SIGNATURE-----


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]