Bug 69234

Summary:	Migrate away from c2man
Product:	FriBidi	Reporter:	Daniel Macks <dmacks>
Component:	docs	Assignee:	Behdad Esfahbod <freedesktop>
Status:	NEW ---	QA Contact:
Severity:	enhancement
Priority:	medium	CC:	freedesktop, niederstrasser
Version:	unspecified
Hardware:	Other
OS:	All
Whiteboard:
i915 platform:		i915 features:

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.