unix man pages are not fully branded

[jnweiger]

genbranding.pl renames the man pages, but the contents always speaks of OWNCLOUD, ownCloud, owncloud. No templates apply.

[jnweiger]

Hmm, do we apply branding when the documentation speaks about 'the ownCloud server' ?

@danimo Sphinx should be able to do variable substitution while building the documentation. Do we have an example?

[hodyroff]

oh mighty. @michaelstingl
Honestly I would just have an option to delete those man pages if so desired, but I don't know if thats more difficult then putting $name or something into them ... there are some borders to branding maybe ;)

[michaelstingl]

@guruz Is it easy to add the branding variables here?

[guruz]

@michaelstingl afaik you need to replace it with a $FILENAME.in (or .cmake) file and then add a link in the CMakeFiles.txt to have cmake process the file when copying it.
You can look at how it is done for admin/osx/post_install.sh.cmake

[michaelstingl]

Who can fix it? @SamuAlfageme ?

[SamuAlfageme]

Yes, I can make a small patch to use the $APPLICATION_EXECUTABLE[cmd] in the manpages, and expand it with Sphinx, it should be that easy.

But my real concern is that these are currently not being copied/linked to /usr/[local/]share/man/man1/ in any [post]installation script (or at least I can't see where; also tried installing owncloud through APT in ubuntu and no luck with it).

btw, the pages seem to be a bit outdated/incomplete:

• owncloud(1)
• owncloudcmd(1)

[guruz]

I don't even think you need Sphinx, you can do it analog to what I described above: #2153 (comment)

[hodyroff]

If you like we can also get rid of the man pages completely ... but lets decide on one direction and get it done for 2.4.

[jnweiger]

Manpages are unmaintained for long. To be removed from templates v2.3.2 and up.

• remove doc-man target in doc/CMakeLists.txt
• make have_doc (html dokumentation) independant of man pages generation
• prevent packaging of man pages in DEB/RPM