format short options break rest

[Martin Pool]

bzr short options like --1.14 and --pack-0.92 break rest/sphinx doc generation because the language does not expect dots in option names.

Possible fixes:

 * work out an escaping syntax and use that
 * remove short options for format names (it's not so common it really needs to be concise)
 * hide the options for ancient formats
 * accept them but don't show it in help

http://doc.bazaar.canonical.com/latest/en/user-reference/init-help.html

There may be some other bugs about the way they're shown in help.

[John A Meinel (jameinel)]

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

On 4/1/2011 9:10 AM, Martin Pool wrote:
> Public bug reported:
>
> bzr short options like --1.14 and --pack-0.92 break rest/sphinx doc
> generation because the language does not expect dots in option names.
>
> Possible fixes:
>
> * work out an escaping syntax and use that
> * remove short options for format names (it's not so common it really needs to be concise)
> * hide the options for ancient formats
> * accept them but don't show it in help
>
> http://doc.bazaar.canonical.com/latest/en/user-reference/init-help.html
>
> There may be some other bugs about the way they're shown in help.
>

I'm pretty sure we hacked around this in our rest front-end for quite
some time.

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk2Xmk4ACgkQJdeBCYSNAAOscwCff0TXXYMZCho3L26+XPpLiTvA
K30AnisPdBg5yni7Ay01zfZsZUuu04zq
=XX9F
-----END PGP SIGNATURE-----

[Martin Pool (mbp)]

> I'm pretty sure we hacked around this in our rest front-end for quite
> some time.

I thought we had too, but it doesn't seem to be happening at the moment.

[Andrew Bennetts (spiv)]

Martin Pool wrote:
> Public bug reported:
>
> bzr short options like --1.14 and --pack-0.92 break rest/sphinx doc
> generation because the language does not expect dots in option names.
>
> Possible fixes:
>
> * work out an escaping syntax and use that

I think the only plausible syntax here is a preformatted block, sadly.

> * remove short options for format names (it's not so common it really needs to be concise)
> * hide the options for ancient formats
> * accept them but don't show it in help

Or

  * rename the formats ;)