[Bug 1176771] [NEW] source code should be converted from noweb to C
Gary Houston
ghouston at arglist.com
Mon May 6 06:17:31 UTC 2013
Public bug reported:
The source code of this package has been written as a single large NoWeb
file. The Makefile automatically converts it into C and documentation.
However, I found this initially mystifying, as I suspect it would also
be to other casual readers who would like to know better how the
software works. I imagine it also makes it difficult to maintain. It
would be easy enough to convert it to a conventional C project:
Run the makefile to generate the C files.
Generate again a few C files that get deleted, for some reason.
Clean up the C files by removing #line indicators and reindenting.
Copy any useful documentation from the noweb file into new C comments.
Rework the makefile to build from C, removing references to noweb.
Delete unneeded noweb files and build tools.
** Affects: ifupdown (Ubuntu)
Importance: Undecided
Status: New
--
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to ifupdown in Ubuntu.
https://bugs.launchpad.net/bugs/1176771
Title:
source code should be converted from noweb to C
Status in “ifupdown” package in Ubuntu:
New
Bug description:
The source code of this package has been written as a single large
NoWeb file. The Makefile automatically converts it into C and
documentation. However, I found this initially mystifying, as I
suspect it would also be to other casual readers who would like to
know better how the software works. I imagine it also makes it
difficult to maintain. It would be easy enough to convert it to a
conventional C project:
Run the makefile to generate the C files.
Generate again a few C files that get deleted, for some reason.
Clean up the C files by removing #line indicators and reindenting.
Copy any useful documentation from the noweb file into new C comments.
Rework the makefile to build from C, removing references to noweb.
Delete unneeded noweb files and build tools.
To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ifupdown/+bug/1176771/+subscriptions
More information about the foundations-bugs
mailing list