Page MenuHomePhabricator

webservice and webservice-runner have no man pages
Open, LowPublic

Event Timeline

scfc created this task.Apr 5 2015, 4:34 AM
scfc raised the priority of this task from to Low.
scfc updated the task description. (Show Details)
scfc added a project: Toolforge.
scfc moved this task to Backlog on the Toolforge board.
scfc added a subscriber: scfc.
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptApr 5 2015, 4:34 AM

We should / can kill webservice from the repo now, it isn't used anywhere (webservice2 is the default webservice now).

We can just put help files in --help there maybe?

scfc added a comment.Apr 5 2015, 10:45 AM

I know, but I want to put webservice{,2} back in the repository. IIRC you pulled it out of there to hot-fix some issues, and now that these have been worked out and after you'll build in the bigbrother replacement, there's no longer a need to pass on tests & Co. (or need +2 from ops). When I review changes, I have a hard time figuring out the semantics of the different options and how they are affected, and I want my laziness back and let Jenkins do the work :-).

Debian's policy for man pages is AFAICS not that they should be there only for executables installed from a package, but that for each command, a user can find a manual by typing man command. So in theory, I would jot down a man page for executables installed by Puppet as well, but with no linter nagging in the past it was easier to just explain how portgrabber works when a user asked for the man page.

scfc renamed this task from webservice/webservice2 have no man pages to webservice and webservice-runner have no man pages.Feb 7 2017, 5:09 PM

Change 437054 had a related patch set uploaded (by Nehajha; owner: Nehajha):
[operations/software/tools-webservice@master] Man page for webservice

https://gerrit.wikimedia.org/r/437054

@scfc could you help reviewing the proposed change by @Nehajha ?

GTirloni removed a subscriber: GTirloni.Dec 20 2018, 6:46 PM