Former RFE 91
We will remove Synopsis from para.char.mix;
CmdSynopsis and FuncSynopsis
will remain, with the processing expectation that they
are inline if used
in an inline context.
The Synopsis element cannot be an inline. CmdSynopsis
could be, but should they?
/ Eduardo Gutentag <Eduardo.Gutentag@Eng.Sun.COM> was
heard to say:
| On the other hand, I don't see a conceptual problem
with something like:
| "The command ls accepts a whole bunch of options and
| file argument: /usr/bin/ls [ -
aAbcCdfFgilLmnopqrRstux1 ] [ file ... ]"
| (the above looks like two lines only by accident)
But does it need to be a synopsis?
The command <command>ls</> accepts a whole bunch of
options and an
optional file argument:
If you've put it inline, do you really need or want to
be able to
point to the whole thing? If it's that important, why
did you run it
The only downside I see is that there's no way to
generate the ellipsis
in the final optional in that command. (Rep is only
on Arg and Group
which can only occur in a CmdSynopsis.)
Log in to post a comment.