[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