darcs

Issue 948 list in darcsman.hs/man_organizer duplicates Darcs.TheCommands.command_control_list

Title list in darcsman.hs/man_organizer duplicates Darcs.TheCommands.command_control_list
Priority wishlist Status resolved
Milestone Resolved in
Superseder Nosy List darcs-devel, dmitry.kurochkin, kowey, thorkilnaur, tommy, twb
Assigned To twb
Topics

Created on 2008-07-04.03:34:37 by twb, last changed 2009-08-27.14:18:29 by admin.

Messages
msg5175 (view) Author: twb Date: 2008-07-04.03:34:33
This list in darcsman.hs

  man_organizer commands = mo commands
                           [("CREATING REPOSITORIES",
                             ["initialize","get"]),
                            ("MODIFYING REPOSITORY CONTENTS",
                             ["add","remove","mv","replace"]),
                            ("WORKING WITH CHANGES",
                             ["record","pull","push","send","apply"]),
                            ("SEEING WHAT YOU'VE DONE",
                             ["whatsnew","query"])
                           ]

Is a stale copy of Darcs.TheCommands.command_control_list

  command_control_list = [Group_name "Changing and querying the working copy:",
                  Command_data add,
                  Command_data remove, Hidden_command unadd, Hidden_command rm,
                  Command_data mv, Hidden_command move,
                  Command_data replace,
  [...]

Instead of rendering uppercased .SH (section headings), I suggest
making a single .SH COMMANDS, then output roff thusly:

    .PP <group name (including colon)>
    .TP
    .B <command name>
    <command help string>
    [...]

Using .PP (simple paragraph) in this way allows the ordinary
Group_name strings to be used; the current approach of .SH would
result in the Group_name strings not fitting on one line (since .SH
use a larger font).
msg5178 (view) Author: kowey Date: 2008-07-04.08:43:53
Please consider submitting a patch for this.  Thanks!
msg6846 (view) Author: twb Date: 2008-12-21.13:41:32
The following patch updated the status of issue948 to be resolved:

* resolve issue948: rewrite darcsman. 

Significant changes are:

 - Avoid duplicating groups from TheCommands.
 - Due to growing command_helps, list commands in SYNOPSIS.
 - Use subsections (.SS) for groups.
 - Include (with fancy markup!) command arguments.
 - Include darcs help --match.
 - Copy-and-paste description from darcs.cabal.
 - Remove AUTHORS section as suggested by man-pages(7).
 - Declare my copyright.
History
Date User Action Args
2008-07-04 03:34:37twbcreate
2008-07-04 08:43:12koweylinkissue949 superseder
2008-07-04 08:43:55koweysetpriority: wishlist
nosy: + kowey
status: unread -> unknown
messages: + msg5178
assignedto: twb
2008-12-21 13:41:35twbsetstatus: unknown -> resolved-in-unstable
nosy: + dmitry.kurochkin, simon, thorkilnaur
messages: + msg6846
2009-04-22 03:30:50twbsetstatus: resolved-in-unstable -> resolved
nosy: tommy, beschmi, kowey, dagit, simon, twb, thorkilnaur, dmitry.kurochkin
2009-08-06 21:09:06adminsetnosy: - beschmi
2009-08-11 00:18:16adminsetnosy: - dagit
2009-08-25 17:36:32adminsetnosy: + darcs-devel, - simon
2009-08-27 14:18:29adminsetnosy: tommy, kowey, darcs-devel, twb, thorkilnaur, dmitry.kurochkin