A graphein-based document system should be kept under some kind of revision control system. I use Subversion, but as graphein is not closely tied to any revision control system, any system could be used. I'll only offer here a few miscellaneous notes.
I found the book Version Control with Subversion by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato (at http://svnbook.red-bean.com/) to be quite useful.
The "svn status" command gives the status of all files from the current working directory down, including those not in Subversion control. To find the status of only svn-controlled files, filter its output to exclude the "?" character:
svn status | grep -v "\?"
The "svn list" command can in general list the repository contents at any revision level. I can't find any reference in the SVN documentation or elsewhere to the default revision level if it is not specified, but it seems to be the revision level of the checked-out tree at the time you checked it out. I find this to be quite confusing, as this is by no means the same as the current contents of the repository! To force "svn list" to use the current revision level, use the "-r HEAD" parameter. Thus, to list the repository's contents at the current revision level (and at the same point in the tree as you are in your checked-out copy, which is the default behavior), verbosely (-v), do:
svn list -v -r HEAD
After creating a new graphein subdirectory (with make-subdirectory.sh), "svn add" it immediately, or at least before doing any make/build in it (that picks up all of the real, initial contents, but doesn't pick up any additional temporary contents from the make/build). Afterwards, "svn add" individual source files as (after) they're created.
The command for an project subtree checkout is (assuming a repository on the local system in /data0/scriptorium/svn-scriptorium", a project named "circuitousroot", and a checkout also of the same name, "circuitousroot"):
All portions of this document not noted otherwise are Copyright © 2006-2007 by David M. MacMillan and Rollande Krandall.
Circuitous Root is a Registered Trademark of David M. MacMillan and Rollande Krandall.
This work is licensed under either of two licenses, at your option:
(A) Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled " GNU Free Documentation License".
(B) This work is licensed under the Creative Commons "Attribution - ShareAlike" license. See http://creativecommons.org/licenses/by-sa/3.0/ for its terms.
Presented originally by Circuitous Root®
Select Resolution: 0 [other resolutions temporarily disabled due to lack of disk space]