view docs/readme-4.0.txt @ 322:69adaab94ffd

Add notes about coding style and submission guidelines. As became clear from recent conversation, matching submitted code to the format of the existing code is not an obvious thing to do. (It should be but apparently it just doesn't occur to people.) Some description of the coding style is now present in the README. Additionally, submission guidelines have also been added to make it clear that patches (diffs) are the preferred means of providing code changes.
author William Astle <lost@l-w.ca>
date Mon, 03 Mar 2014 21:54:12 -0700
parents 2c24602be78f
children
line wrap: on
line source

With LWTOOLS 4.0, a substantial reorganization of the project has occurred.
This document serves to explain the reasoning behind the various changes.

The most obvious change is that the gnu auto tools have been eliminated.
While they proved useful for initial distribution of the software,
particularly for construction of the win32 binaries, they have since proved
to add an unacceptable level of complexity to every aspect of development
from merely tinkering with source files to doing complete releases. Thus,
the auto tools have been ditched in favour of specific hand tuned help where
required.

The other substantial change is that the source code repository has been
recreated from scratch. The old repository was full of cruft from various
revision control systems that were used over the years (CVS, Subversion, and
Mercurial). It was felt that starting a new Mercurial repository with a
completely clean slate would simplify matters substantially. Thus, the old
repository now serves as an archive.