Bug 69234 - Migrate away from c2man
Summary: Migrate away from c2man
Status: NEW
Alias: None
Product: FriBidi
Classification: Unclassified
Component: docs (show other bugs)
Version: unspecified
Hardware: Other All
: medium enhancement
Assignee: Behdad Esfahbod
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-09-11 16:39 UTC by Daniel Macks
Modified: 2017-12-10 22:45 UTC (History)
2 users (show)

See Also:
i915 platform:
i915 features:


Attachments

Description Daniel Macks 2013-09-11 16:39:54 UTC
Fribidi uses c2man to generate its manpage, but c2man is pretty dead. Debian removed it from their distro in around 2005. Ubuntu had it on life-support until 2011, but with a large warning to avoid using it due to upstream dead/abandoned and better modern solutions. Both distros recommend doxygen as an alternative. Therefore, this is a request to switch fribidi to using some other documentation system. Requiring an obsolete and not-widely/directly-available to (re)generate the manpage makes it more difficult to hack/port fribidi.
Comment 1 Behdad Esfahbod 2013-09-11 17:02:39 UTC
Right...  FWIW I have a fork of c2man that I use to generate fribidi's docs:

  http://cgit.freedesktop.org/fribidi/c2man/

This was all written back in 2005...  I don't have time or motivation to change it now since the library itself has not changed in almost a decade.
Comment 2 Alexandre Demers 2017-12-09 23:21:20 UTC
For your info, I know it's an old bug, but I'm working on it. I've created a branch named Doxygen at https://github.com/Oxalin/fribidi/tree/doxygen

Building fribidi build the new doc, but I still want to tune it a bit before proposing a merge.
Comment 3 Behdad Esfahbod 2017-12-10 22:45:16 UTC
Please open an issue or Pull-Request on github soon so others are also aware of your work.  Thanks.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.