hi there, i am trying to learn fossil and 'fossil help' is a great tool for this. however as a newcomer i have noticed a couple of "discrepancies".
i have already worked out that fossil is liberal with command line switches and accepts --longoptions with a single '-' as well. as it looks like that the great majority of documentation is written in the --longoption form, i think it would be nice to have all these commands in the same form. fossil is not liberal only with the form but also with the position of the options, another thing that might not be obvious for new users (and i haven't found it anywhere in the documentation so far), so again, some sort of consistency would be nice. as a bsd user, i am great fan of consistent description of command line options and i think that command [options] [arguments] works quite well. in the fossil help, ?OPTIONS? is sometimes before, sometimes after the arguments. and lastly, the notation of a parameter being optional or not is also a bit of curiousity for me, i have never seen the ?OPTIONS? notation before, and while its clear, what's it about, i think [OPTIONS] is a more common and recognized form for command line programs. a quick search through the sources indicates that a very small minority of the commands use [ ] instead of ? ?... if there is interest for this from the architect, i'd be more than happy to send a diff that would make these changes. -f -- unicorns aren't myth, virgins are! _______________________________________________ fossil-users mailing list [email protected] http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users
