Re: [fossil-users] incomplete documentation?

2013-08-09 Thread Isaac Jurado
El 09/08/2013 14:18, "Richard Hipp" escribió: > > > > On Fri, Aug 9, 2013 at 7:40 AM, Isaac Jurado wrote: >> >> As I understand it, in Fossil, the history is mostly driven by the date >> and time of the events, whereas in Git and Hg ancestry relationship >> comes first. I gues this is one of the

Re: [fossil-users] incomplete documentation?

2013-08-09 Thread Stephan Beal
On Fri, Aug 9, 2013 at 1:36 PM, j. van den hoff wrote: > fossil --user joedoe ci filename > > fossil ci --user joedoe filename > > the second version looks "normal" in that `ci' apparently takes a `--user' > option plus argument. the first one is the "problem" for the `fsl' > wrapper since it of c

Re: [fossil-users] incomplete documentation?

2013-08-09 Thread Richard Hipp
On Fri, Aug 9, 2013 at 7:40 AM, Isaac Jurado wrote: > As I understand it, in Fossil, the history is mostly driven by the date > and time of the events, whereas in Git and Hg ancestry relationship > comes first. I gues this is one of the reasons of why there typical > "log" command is called "tim

Re: [fossil-users] incomplete documentation?

2013-08-09 Thread Isaac Jurado
Replying j. van den hoff: > as a follow up on this (and the response to the original post by drh): > > it _is_ bad that options like `--date-override' are not > comprehensively documented (notably with `commit') since they can be > important for "normal" users as well. e.g.: > > accidentally, I'm j

Re: [fossil-users] incomplete documentation?

2013-08-09 Thread j. van den hoff
coming back to this (the question whether or not there are `fossil' options like `--user'). my interest in this question is related to this project http://fossil.0branch.com/fsl where the wrapper script `fsl' which can be used as a transparent drop-in replacement for the `fossil' command (

Re: [fossil-users] incomplete documentation?

2013-08-09 Thread j. van den hoff
as a follow up on this (and the response to the original post by drh): it _is_ bad that options like `--date-override' are not comprehensively documented (notably with `commit') since they can be important for "normal" users as well. e.g.: accidentally, I'm just now in the somewhat painful

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread j. van den hoff
On Thu, 08 Aug 2013 19:49:18 +0200, Richard Hipp wrote: On Thu, Aug 8, 2013 at 12:40 PM, Julian wrote: One of the problems is that the help given by fossil help isn't always complete. For example the help for checkin (fossil help ci), doesn't list the --date-override or --user-override

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Richard Hipp
On Thu, Aug 8, 2013 at 12:40 PM, Julian wrote: > One of the problems is that the help given by fossil help isn't > always complete. For example the help for checkin (fossil help ci), doesn't > list the --date-override or --user-override options, even though they > appear to be accepted. The same

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Stephan Beal
On Thu, Aug 8, 2013 at 6:40 PM, Julian wrote: > The only way I've found to discover them is to use "grep find_option" on > the source - I'm not sure that is very user-friendly. > It is for fossil's original intended audience ;). But, yeah, i admit that it's not ideal. Tell you what: look around

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Julian
One of the problems is that the help given by fossil help isn't always complete. For example the help for checkin (fossil help ci), doesn't list the --date-override or --user-override options, even though they appear to be accepted. The same appears to be the case for the branch command. The

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Stephan Beal
On Thu, Aug 8, 2013 at 5:13 PM, j. van den hoff wrote: > well that's sort of difficult for the average user I'd say since he does > not _know_ > what the parser is doing and what the set of valid calls to fossil looks > like. I cannot be sure, > for instance that there are no further undocumented

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread j. van den hoff
On Thu, 08 Aug 2013 17:00:08 +0200, Stephan Beal wrote: On Thu, Aug 8, 2013 at 2:32 PM, Stestagg wrote: I would agree here, it's not at all clear. Even when you know there is a --user option, then the fossil output isn't clear: In Fossil's defense: i've been using Fossil almost daily

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Stephan Beal
On Thu, Aug 8, 2013 at 2:32 PM, Stestagg wrote: > I would agree here, it's not at all clear. Even when you know there is a > --user option, then the fossil output isn't clear: > In Fossil's defense: i've been using Fossil almost daily since Christmas 2007 and haven't every used --user. steves@

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Stestagg
I would agree here, it's not at all clear. Even when you know there is a --user option, then the fossil output isn't clear: steves@sapphire ~> f ls fossil: current directory is not within an open checkout # OK steves@sapphire ~> f --user foo fossil: fossil: unknown command: --user fossil: use "

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread j. van den hoff
On Thu, 08 Aug 2013 14:03:42 +0200, Stephan Beal wrote: On Thu, Aug 8, 2013 at 1:38 PM, j. van den hoff wrote: question: should there not be a help page for fossil itself, maybe (`fossil help fossil') which explains this sort of things? Is this perhaps what you're looking for: [stephan@

Re: [fossil-users] incomplete documentation?

2013-08-08 Thread Stephan Beal
On Thu, Aug 8, 2013 at 1:38 PM, j. van den hoff wrote: > question: should there not be a help page for fossil itself, maybe > (`fossil help fossil') which explains this sort of things? Is this perhaps what you're looking for: [stephan@host:~]$ f help help Usage: f help COMMAND or: f COMMAND

[fossil-users] incomplete documentation?

2013-08-08 Thread j. van den hoff
hi, I just encountered the need to do something like fossil --user joedoe ci after trying `fossil ci' failed, `fossil' recommended to use the --user flag. this flag seems nowhere to be mentioned in the builtin help pages (I scanned all pages for the commands displayed by `fossil help -a'). I