Re: [fossil-users] fossil help set no longer provides essential information

[info]

Hallöchen!


Von meinem iPhone gesendet


___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Re: [fossil-users] fossil help set no longer provides essential information

[Matt Welland]

On Fri, 2018-01-05 at 13:06 -0700, Andy Bradford wrote:
> Thus said Richard Hipp on Fri, 05 Jan 2018 13:42:29 -0500:
> 
> > 
> > Maybe  I just  need to  improve the  "fossil help  setting"
> > output  to
> > provide some clue about how to get help on individual settings?
> That would be an  improvement as just in responding to  this email I
> had
> to figure out how to get the new settings help because it wasn't
> obvious
> to me that the  domain of settings help has now  entered the same
> domain
> as subcommand help, but it still means that, one has to run a minimum
> of
> 2 commands. With the current state of settings help:
> 
> 1) fossil settings (inspect settings list and pick one interesting)
> 2) fossil help 
> 
> Before, it was easier just to run:
> 
> fossil help settings
> 
> Then scroll up through the output, or use a $PAGER.
> 
> Maybe a  --verbose option to fossil  help settings would make  it so
> one
> can get  all the information in  a single request? Matt,  what would
> you
> think is an improvement?

This is a case where I think the original implementation was ok but
yes, a --full or --verbose would also work. 

> Andy
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Re: [fossil-users] fossil help set no longer provides essential information

[info]

Hallöchen!


Von meinem iPhone gesendet


___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Re: [fossil-users] fossil help set no longer provides essential information

[Matt Welland]

On Fri, 2018-01-05 at 13:42 -0500, Richard Hipp wrote:
> On 1/5/18, Matt Welland  wrote:
> > 
> > Older versions of fossil would provide some very helpful
> > information
> > from "fossil help set":
> > 
> > gmerge-command   A graphical merge conflict resolver command
> > operating
> >  on four files.
> >   Ex: kdiff3 "%baseline" "%original" "%merge" -o
> > "%output"
> >   Ex: xxdiff "%original" "%baseline" "%merge" -M
> > "%output"
> >   Ex: meld "%baseline" "%original" "%merge" "%output"
> > 
> > Having to start up a UI and dig around for these example merge
> > commands
> > is a bit annoying.
> The "fossil help gmerge-command" command should show you want you
> want, does it not?  I did split off the pages and pages of details
> for
> all settings out of the "fossil help settings" command into separate
> "help" pages for each setting.  But I thought that was a feature.  Do
> you disagree?  Or am I misunderstanding your problem?
> 
> Maybe I just need to improve the "fossil help setting" output to
> provide some clue about how to get help on individual settings?
> 
I had tried "fossil help set gmerge" which is similar to how other
tools handle complicated multi-layered help. It didn't occur to me to
try "fossil help gmerge" as gmerge is not a command:

fossil gmerge
fossil: unknown command: gmerge
fossil: use "help" for more information
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Re: [fossil-users] fossil help set no longer provides essential information

[Andy Bradford]

Thus said Richard Hipp on Fri, 05 Jan 2018 13:42:29 -0500:

> Maybe  I just  need to  improve the  "fossil help  setting" output  to
> provide some clue about how to get help on individual settings?

That would be an  improvement as just in responding to  this email I had
to figure out how to get the new settings help because it wasn't obvious
to me that the  domain of settings help has now  entered the same domain
as subcommand help, but it still means that, one has to run a minimum of
2 commands. With the current state of settings help:

1) fossil settings (inspect settings list and pick one interesting)
2) fossil help 

Before, it was easier just to run:

fossil help settings

Then scroll up through the output, or use a $PAGER.

Maybe a  --verbose option to fossil  help settings would make  it so one
can get  all the information in  a single request? Matt,  what would you
think is an improvement?

Andy
-- 
TAI64 timestamp: 40005a4fdadd


___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Re: [fossil-users] fossil help set no longer provides essential information

[Richard Hipp]

On 1/5/18, Matt Welland  wrote:
> Older versions of fossil would provide some very helpful information
> from "fossil help set":
>
> gmerge-command   A graphical merge conflict resolver command operating
>  on four files.
>   Ex: kdiff3 "%baseline" "%original" "%merge" -o "%output"
>   Ex: xxdiff "%original" "%baseline" "%merge" -M "%output"
>   Ex: meld "%baseline" "%original" "%merge" "%output"
>
> Having to start up a UI and dig around for these example merge commands
> is a bit annoying.

The "fossil help gmerge-command" command should show you want you
want, does it not?  I did split off the pages and pages of details for
all settings out of the "fossil help settings" command into separate
"help" pages for each setting.  But I thought that was a feature.  Do
you disagree?  Or am I misunderstanding your problem?

Maybe I just need to improve the "fossil help setting" output to
provide some clue about how to get help on individual settings?

-- 
D. Richard Hipp
d...@sqlite.org
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

[fossil-users] fossil help set no longer provides essential information

[Matt Welland]

Older versions of fossil would provide some very helpful information
from "fossil help set":

gmerge-command   A graphical merge conflict resolver command operating
                 on four files.
              Ex: kdiff3 "%baseline" "%original" "%merge" -o "%output"
              Ex: xxdiff "%original" "%baseline" "%merge" -M "%output"
              Ex: meld "%baseline" "%original" "%merge" "%output"

Having to start up a UI and dig around for these example merge commands
is a bit annoying. I don't know if this was an intentional change but I
would very much like to have the old help information available from
the command line.

Just my $0.02
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users