Ray Lai <r...@raylai.com> writes:

> On 10/23/16 18:53, Ray Lai wrote:
>> Based on Carlos Alberto Pereira Gomes's work:
>> https://marc.info/?l=openbsd-ports&m=105265115901089&w=2
>> 
>> DESCR:
>> noweb is designed to meet the needs of literate programmers while
>> remaining as simple as possible. Its primary advantages are simplicity,
>> extensibility, and language-independence—especially noticeable
>> when compared with other literate-programming tools. noweb uses 5
>> control sequences to WEB's 27. The noweb manual is only 4 pages;
>> an additional page explains how to customize its LaTeX output. noweb
>> works ``out of the box'' with any programming language, and supports
>> TeX, latex, HTML, and troff back ends. A back end to support full
>> hypertext or indexing takes about 250 lines; a simpler one can be
>> written in 40 lines of awk.  The primary sacrifice relative to WEB
>> is that code is seldom prettyprinted.
>> 
>> 
>> 
>> I removed the elisp support, as the homepage states "In 2012, I learned
>> that there is no longer any Emacs mode that supports Noweb and really
>> works with Emacs 23 or Emacs 24."
>> 
>> Enjoy!
>
> Cleaned things up (strcpy, some malloc checks).

Looks fine, except for the following items:
- COMMENT should not start with a capital letter or an article
- kill the first line of DESCR, as it is the same as COMMENT.  I'm
  wondering whether the last paragraph actually adds value. *shrug*

The strcpy/malloc/etc changes don't seem to fix actual problems (sorry
if I'm wrong here). Checking for malloc returning NULL is good practice,
but the only gain here would be a fatal error message instead of
a crash. Also it feels weird to introduce strlcat in an old codebase
that still uses a local getline function. I suggest that you propose
improvements upstream first.

Here's an updated tarball.  Can I get another review?

Attachment: noweb.tgz
Description: Binary data

-- 
jca | PGP : 0x1524E7EE / 5135 92C1 AD36 5293 2BDF  DDCC 0DFA 74AE 1524 E7EE

Reply via email to