CSA, Copyright (c) 2000,2008 by Carlo Strozzi.
CSA comes with ABSOLUTELY NO WARRANTY; for details refer to the GNU General Public License.
You should have received a copy of the GNU General Public License along with this work; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
CSA is a small application development environment for the World-Wide Web. CSA tends to be biased in favour of GNU/Linux. This means that, wherever it matters, CSA makes use of the GNU versions of the various UNIX commands, as those are the ones that are usually packaged together with the Linux O.S. And among the many Linux "distributions" available nowadays, CSA has been developed entirely on Debian, although it should run just as fine on any other common Linux distributions. CSA is Free Software, released under the terms of the GNU General Public License. As such, it fully qualifies as Open Source Software.
For a thorough understanding of this paper you need to have a fairly good knowledge of the UNIX/Linux Programming Environment, that is the shell and the main shell utilities, like sed, grep, find, etc. Some basic familiarity with the C language won't hurt either. The utilities I refer to in the rest of this document are the GNU incarnations of such tools. It is definitely required that the reader has a good knowledge of the rc shell, a rather minimal scripting language which syntax is half-way between the C-shell and the Bourne shell. Of course it is necessary to know the technology the World Wide Web is built upon, and in particular how the CGI (Common Gateway Interface) works.
Most important, to really grasp the CSA philosophy I definitely recommend that you read the resources listed in the bibliography.
In the text that follows,
prescriptive rules are identified by upper-case adverbs like "
SHOULD", "
SHOULD NOT", "
MUST" and "
MUST NOT", while
descriptive adverbs are left in lower-case.
There is a mailing list for discussions related to CSA. The address is
csa-devel@strozzi.it. To subscribe simply send a message to
csa-devel-request@strozzi.it with the phrase "
subscribe csa-devel" (without the quotes) in the message
subject.
Please send bug reports (fixes are most welcome) to the same list
csa-devel@strozzi.it. Always include as much information as possible, especially the content of file
csa.version, which is created in the CSA installation directory during install. By
bug reports I mean not just errors in the code, but also grammatical mistakes, typos and bad English constructions in the documentation, as English isn't my native language.
Pages on this Web site are organized in the form of a Wiki. These pages can be edited by any standard Web browser -- provided you have been granted the proper authorization.
1 UNIX is a registered trademark of The Open Group. All brand names, product names, or trademarks mentioned in this publication belong to their respective owners.