diff --git a/Manuals/Tcar-ug/Repository/Workstation/config.docbook b/Manuals/Tcar-ug/Repository/Workstation/config.docbook index 9965f08..d73b4ce 100644 --- a/Manuals/Tcar-ug/Repository/Workstation/config.docbook +++ b/Manuals/Tcar-ug/Repository/Workstation/config.docbook @@ -11,9 +11,7 @@ - Workplace - Once you've installed the workstation and it is up and running, you need to create the user name you'll use for your @@ -39,17 +37,14 @@ create only a user identifier for you to login, but a place for you to store your information, as well. This place is known as your home directory and is unique for each user - inside the workstation. At the moment, we face the following - design problems related to handling absolute paths inside the - working copies of &TCAR;: + inside the workstation. At this point, it is necessary to + decide where the working copy tree will be stored in the + workstation filesystem. - - - Case 1: Different home directories - - Assuming you store your working copy under Case 1: Different Home Directories + — Assuming you store your working copy under /home/john/artwork/ and I store mine under /home/al/artwork/, we'll end up @@ -58,18 +53,13 @@ files, holding path information inside, are committed up to the central repository. The contradiction comes from the question: which is the correct absolute path to use inside - such files, yours or mine? — No one of them is, of - course. + such files, yours or mine? (None of them is, of course.) - - - - Case 2: One unique home directory - - Another case would be that you and I ourselves use one unique - home directory (e.g., Case 2: One Unique Home Directory — + Another case would be that where you and I ourselves use one + unique home directory (e.g., /home/centos/artwork/) to store the working copy of &TCAR; in our own workstations, but configure the subversion client to use different user names to @@ -84,34 +74,28 @@ different subversion credentials for committing changes to be lost. - - - - Case 3: Different home directories through dynamic expansion - - Most of the absolute paths we use inside the working copy are - made of two parts, one dynamic and one fixed. The dynamic part - is the home directory of the current user and its value can be - retrived from the $HOME environment variable. - The fixed part of the path is the one we set inside the - repositroy structure itself as organization matter. What we - need here is to find a way to expand variables inside files - that don't support variable expansion. So far we've been - doing this through creation template instances which are - temporal files with translation markers expanded inside. This - work rather fine with template files that are one-time-pass - (e.g., when we produce produce PNG files from SVG files and - XTHML from DocBook files), but the same is not true for - absolute paths inside files that are used as in their - permanent state inside the repository (e.g., CSS files and - other files similar in purpose). + Case 3: Different Home Directories Through Dynamic + Expansion — Most of the absolute paths we use + inside the working copy are made of two parts, one dynamic and + one fixed. The dynamic part is the home directory of the + current user and its value can be retrived from the + $HOME environment variable. The fixed part of + the path is the one we set inside the repositroy structure + itself as organization matter. What we need here is to find a + way to expand variables inside files that don't support + variable expansion. So far we've been doing this through + creation template instances which are temporal files with + translation markers expanded inside. This work rather fine + with template files that are one-time-pass (e.g., when we + produce produce PNG files from SVG files and XTHML from + DocBook files), but the same is not true for absolute paths + inside files that are used as in their permanent state inside + the repository (e.g., CSS files and other files similar in + purpose). - - - - + From the three cases discussed above, the second one (i.e., One unique home directory) seems to be the best candidate. It