Sintaxe da sinopse nas páginas de manuais [Era: Re: bug na página-manual do sqlite?

[marciotex@pop.com.br]

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

Otavio Salvador <otavio@debian.org> writes:

> || On Thu, 14 Oct 2004 18:34:22 -0300
> || marciotex@pop.com.br wrote: 
>
> m> SYNOPSIS
> m>        sqlite [options] filename [SQL]
>
> ...
> m> é ilegal, certo? Digo, a sinopse afirma que filename é obrigatória na
> m> sintaxe do comando. Estou certo?
>
> Isso. Correto.
>
> m> Isto é um bug? Devo reportá-lo ao pacote?
>
> Sim, reporte :-)

Olá Otávio.

Obrigado por responder. Reportarei o bug. Mas desta vez quero
avançar. Vou mandar a correção (patch) para o autor. Tenho algumas
dúvidas.

Já baixei os fontes do pacote (deb-src) para gerar o diff. A versão
testing e a unstable tem o problema. Reporto para ambas? Faço dois
diff's? O doc How to report a bug in Debian não dirimiu estas dúvidas. 

Outra questão é quanto à sintaxe das sinopses nas páginas de
manual. Supondo que as seguintes formas são legais:

sqlite
sqlite options
sqlite filename
sqlite options filename
sqlite options filename sql
sqlite filename sql

e ***não*** estas

sqlite options sql
sqlite sql

Como expressar isto na sinopse? Ou seja, como expressar que

sql somente se filename

?

A minha sugestão:

sqlite [options] filename [sql]
sqlite [options] [filename]

Estou certo?

Agradeço, desde já, a boa-vontade. 

Um abraço,
- - -- 
Marcio Roberto Teixeira

endereço eletrônico: marciotex@pop.com.br
chave pública: hkp://wwwkeys.pgp.net
                        http://www.marciotex.pop.com.br/keypub_8709626B.asc
página pessoal (em construção): http://www.marciotex.pop.com.br
Usuário "tchê" Debian/GNULinux

Porto Alegre - RS - Brasil
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/>

iD8DBQFBb1w0rD1pS4cJYmsRAm0eAJ9QRzyHo6aBrgCKIlQHX85ddZawzACeIbVr
XPQKBj9C8elxcBpmp4gV9N4=
=+4nw
-----END PGP SIGNATURE-----