Opened 9 years ago

Closed 8 years ago

#4619 defect closed fixed (fixed)

doc/core/man/twistd.1 seems outdated

Reported by: Yaroslav Fedevych Owned by: Thijs Triemstra
Priority: normal Milestone:
Component: core Keywords: documentation, manpage
Cc: Thijs Triemstra Branch:


There is a couple of things in man 1 twistd which can be seen as typos, and some describe things which apparently are not there anymore.

First, there is some tautology. A fragment near --rundir is as follows:

       -d, --rundir <directory>
              Change to a supplied directory before running (default: .).
       -u, --uid <uid>
              The uid to run as (default: don't change).
       -g, --gid <gid>
              The gid to run as (default: don't change).

and then a bit further:

       -g, --plugin <plugin name>
              Read config.tac from a plugin package, as with -y.
              Log to syslog instead of a file.
       -u, --uid <uid>
              The uid to run as.
       -g, --gid <gid>
              The gid to run as.

First, I believe the --plugin parameter went away at some point, as twistd doesn't display it altogether. Second, -g --plugin conflicts with -g --gid. And third, --uid and --gid are described in two places.

Attachments (1)

twistd-man.patch (1.5 KB) - added by Thijs Triemstra 8 years ago.

Download all attachments as: .zip

Change History (8)

comment:1 Changed 9 years ago by Yaroslav Fedevych

Keywords: manpage added

comment:2 Changed 8 years ago by <automation>

Owner: Glyph deleted

Changed 8 years ago by Thijs Triemstra

Attachment: twistd-man.patch added

comment:3 Changed 8 years ago by Thijs Triemstra

Cc: Thijs Triemstra added
Keywords: documentation review added; docs removed

comment:4 Changed 8 years ago by jesstess

Owner: set to Thijs Triemstra

Thanks for reporting this, jafd, and thanks for working up a patch, thijs.

Looks good, please merge.

comment:5 Changed 8 years ago by jesstess

Keywords: review removed

comment:6 Changed 8 years ago by Thijs Triemstra

Status: newassigned

#5125 was a duplicate but merged, so I'll just apply the rest of the patch which removes the --plugin option.

comment:7 Changed 8 years ago by Thijs Triemstra

Resolution: fixed
Status: assignedclosed

(In [32006]) Apply twistd-man.patch: Remove old --plugin option and update dates.

Author: thijs Reviewer: jesstess Fixes: #4619

Note: See TracTickets for help on using tickets.