Task #1446
closedNFD documentation and manpages
100%
Description
NFD documentation should contain tutorial sections (installation instruction, configuration tips, etc.).
Also, each executable bundled in NFD needs a man page.
The skeleton for manpages is in docs
folders and the following process is to create a new page:
- add new
.rst
file indocs/manpages
- modify man_pages variable in
docs/conf.py
Updated by Junxiao Shi over 10 years ago
- Category set to Tools
- Target version set to v0.1
Updated by Alex Afanasyev over 10 years ago
- Subject changed from NFD manpages to NFD documentation and manpages
- Description updated (diff)
- % Done changed from 0 to 20
Updated by Alex Afanasyev over 10 years ago
- Status changed from New to Code review
Updated by Alex Afanasyev over 10 years ago
- Assignee set to Hila Ben Abraham
Hila, can you add manpages for the rest of command-line tools we have?
Updated by Hila Ben Abraham over 10 years ago
Sure, I can do that during the weekend.
Updated by Hila Ben Abraham over 10 years ago
Should I use Change-Id: I4f02f3166e7802570b24ed225ac4de8c56c6e64e ?
Updated by Alex Afanasyev over 10 years ago
Create a new commit (after this one is merged).
Updated by Hila Ben Abraham over 10 years ago
Should I use
./waf docs
to generate the man pages? I tried but my build failed. (I can post the output if that's the right way to do it).
I just pushed Change-Id: I3eba0d125f7da51696342edce1a2f1ee33a0471a, but since the build failed, I couldn't verify it's actually working.
Updated by Alex Afanasyev over 10 years ago
Manpages are build during just ./waf
(same as ./waf build
).
Have you installed sphinx-build as described in README-dev.md? If so, did you reconfigure?
Updated by Alex Afanasyev over 10 years ago
Forgot to mention. Manpages are also part of the documentation that can be build with the command you mentioned (./waf docs
). What errors you're getting and on which platform you're running it?
Updated by Hila Ben Abraham over 10 years ago
Just checked and sphinx-build is missing, I'll check again once I have it installed.
Updated by Alex Afanasyev over 10 years ago
If doxygen is missing, ./waf docs
may also fail. However, there is ./waf sphinx
to build just sphinx docs without API.
Updated by Alex Afanasyev over 10 years ago
- Status changed from Code review to In Progress
Updated by Alex Afanasyev over 10 years ago
Hi Hila. Do you have progress on this issue?
Updated by Hila Ben Abraham over 10 years ago
I still have to complete the example section in each of the manpages. Sorry, I'm in the middle of my finals period, so I'm busy with other things. How urgent is this task?
Updated by Alex Afanasyev over 10 years ago
We need them before the release, which is coming very soon. If you can update the commit (even without example), we give some early comments/suggestions.
Updated by Alex Afanasyev over 10 years ago
Let me know if you want this task to be re-assigned to someone else. We have 4 days till the release.
Updated by Hila Ben Abraham over 10 years ago
Can you please re-assign 'nfd' manpage? I will push all the others tonight.
Updated by Syed Amin over 10 years ago
Hila, if you haven't finished nfdc manpage I can do it.
Updated by Syed Amin over 10 years ago
Sorry, it was typo in my first message. I meant "nfdc" manpage not nfd.
Updated by Hila Ben Abraham over 10 years ago
Thanks Syed, I have actually finished with nfdc...
Updated by Alex Afanasyev over 10 years ago
- Status changed from In Progress to Code review
- % Done changed from 70 to 100
Updated by Alex Afanasyev over 10 years ago
- Status changed from Code review to Closed