MFen: 1.15 -> 1.16

Add a role="directory" attribute to all the <filename> elements that
reference directory paths.
This commit is contained in:
Giorgos Keramidas 2006-01-23 00:50:37 +00:00
parent 4b0a76e253
commit c7b94fa4c5
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=26934

View file

@ -1,4 +1,4 @@
<!-- Original version: 1.15 -->
<!-- Original version: 1.16 -->
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EL">
@ -90,7 +90,7 @@
<screen>&prompt.user; <userinput>cvs -d <replaceable>path-to-repository</replaceable> init</userinput></screen>
<para>Αυτό λέει στο <application>CVS</application> να δημιουργήσει τον
φάκελο διαχείρισης <filename>CVSROOT</filename>, όπου συμβαίνουν όλες
φάκελο διαχείρισης <filename role="directory">CVSROOT</filename>, όπου συμβαίνουν όλες
οι παραμετροποιήσεις.</para>
</sect2>
@ -118,13 +118,13 @@
<sect2>
<title>Παίρνοντας τον πηγαίο κώδικα</title>
<para>Τώρα θα πρέπει να αποκτήσετε τον κατάλογο <filename>CVSROOT</filename>
<para>Τώρα θα πρέπει να αποκτήσετε τον κατάλογο <filename role="directory">CVSROOT</filename>
από το repository του FreeBSD. Αυτό γίνεται εύκολα, κάνοντας
check out από ένα ανοιχτής πρόσβασης FreeBSD CVS mirror. Δείτε <ulink
url="&url.books.handbook;/anoncvs.html">το
σχετικό κεφάλαιο στο εγχειρίδιο</ulink> για περισσότερες
πληροφορίες. Ας υποθέσουμε ότι ο πηγαίος κώδικας θα αποθηκευτεί στον
κατάλογο <filename>CVSROOT-freebsd</filename> που βρίσκεται μέσα στον
κατάλογο <filename role="directory">CVSROOT-freebsd</filename> που βρίσκεται μέσα στον
τρέχοντα κατάλογο.</para>
</sect2>
@ -132,13 +132,13 @@
<title>Αντιγράφοντας τα scripts του FreeBSD</title>
<para>Ύστερα, αντιγράφουμε τον πηγαίο κώδικα από τον
<filename>CVSROOT</filename> κατάλογο του FreeBSD στο δικό μας repository. Αν είστε
<filename role="directory">CVSROOT</filename> κατάλογο του FreeBSD στο δικό μας repository. Αν είστε
συνηθισμένος με το <application>CVS</application>, ίσως να
σας περάσει από το μυαλό να προσπαθήσετε να κάνετε import τα scripts, σε μια προσπάθεια να
γίνει ύστερα ο συγχρονισμός με τις κατοπινές εκδόσεις ευκολότερος.
Ωστόσο, αποδεικνύεται ότι το <application>CVS</application> παρουσιάζει
μια δυσλειτουργία στην περιοχή αυτή: Όταν εισάγετε πηγαίο κώδικα μέσα
στο <filename>CVSROOT</filename> φάκελο, δεν θα ενημερωθούν τα
στο <filename role="directory">CVSROOT</filename> φάκελο, δεν θα ενημερωθούν τα
απαραίτητα αρχεία διαχείρισης. Για να μπορέσετε να το κάνετε να τα
αναγνωρίσει, θα πρέπει να κάνετε checkin ξεχωριστά κάθε αρχείο αφού
έχετε τελειώσει με την εισαγωγή, χάνοντας έτσι την αξία του
@ -147,7 +147,7 @@
<para>Δεν είναι και τόσο σημαντικό το αν η παραπάνω παράγραφος δεν σας
φαίνεται πολύ ξεκάθαρη&mdash;το τελικό αποτέλέσμα είναι το ίδιο. Απλά
ελέγξτε τον <filename>CVSROOT</filename> φάκελο και αντιγράψτε τα
ελέγξτε τον <filename role="directory">CVSROOT</filename> φάκελο και αντιγράψτε τα
FreeBSD αρχεία πάνω από τα δικά σας τοπικά (απείραχτα) αντίγραφα:</para>
<screen>&prompt.user; <userinput>cvs -d <replaceable>path-to-your-repository</replaceable> checkout CVSROOT</userinput>
@ -316,7 +316,7 @@
να προσθέσετε τις ανάλογες κανονικές εκφράσεις στο αρχείο αυτό
όταν κάνετε checkin αρχεία που δεν είναι απαραίτητο να περιέχουν επικεφαλίδα
επισκόπησης. Κατά τη διάρκεια της εγκατάστασης των νέων scripts ελέγχου, ίσως να είναι
καλύτερα να εξαιρείται ο κατάλογος <filename>CVSROOT/</filename>
καλύτερα να εξαιρείται ο κατάλογος <filename role="directory">CVSROOT/</filename>
από τον έλεγχο των headers.</para>
</listitem>
@ -512,7 +512,7 @@
<listitem>
<para><literal>$MAIL_BRANCH_HDR</literal> - Αν θέλετε να
προσθέσετε μια επικεφαλίδα σε κάθε commit μήνυμα mail που θα
προστίθεται αυτόματα μια επικεφαλίδα σε κάθε commit μήνυμα mail, η οποία θα
περιγράφει το branch στο οποίο έγινε το συγκεκριμένο commit,
ορίστε την τιμή αυτή να ταιριάζει με την δική σας
εγκατάσταση. Αφήστε την κενή αν δεν επιθυμείτε να προστίθεται αυτόματα μια
@ -521,8 +521,8 @@
<listitem>
<para><literal>@COMMIT_HOSTS</literal> - Ορίστε την τιμή αυτή
σε μια λίστα από hosts από τους οποίους μπορούν να
επιτρέπονται commit.</para>
σε μια λίστα από συστήματα (hosts), από τα οποία επιτρέπεται
να γίνονται commits.</para>
</listitem>
<listitem>
@ -536,9 +536,11 @@
<para><literal>@LOG_FILE_MAP</literal> - Αλλάξτε αυτό το array
όπως επιθυμείτε. Κάθε regexp αντιστοιχεί στο συγκεκριμένο
φάκελο στον οποίο γίνεται το commit, και το log μήνυμα του
commit αποθηκεύεται στον υποκατάλογο
<filename>commitlogs</filename> στο αρχείο που
αναφέρεται.</para>
commit αποθηκεύεται κάτω από τον κατάλογο
<filename role="directory">CVSROOT</filename>, στον υποκατάλογο
<filename role="directory">commitlogs</filename>, στο αρχείο που
αναφέρεται στην αντίστοιχη εγγραφή του
πίνακα <literal>@LOG_FILE_MAP</literal>.</para>
</listitem>
<listitem>
@ -551,16 +553,16 @@
</listitem>
</itemizedlist>
<note>
<para>Η αλλαγή της παραμέτρου <literal>$IDHEADER</literal> είναι
εγγυημένο ότι θα δουλέψει μόνο σε πλατφόρμες FreeBSD. Εξαρτάται
από ειδικές μετατροπές του FreeBSD στο
<application>CVS</application>.</para>
</note>
<note>
<para>Η αλλαγή της παραμέτρου <literal>$IDHEADER</literal> είναι
εγγυημένο ότι θα δουλέψει μόνο σε πλατφόρμες FreeBSD. Εξαρτάται
από ειδικές μετατροπές του FreeBSD στο
<application>CVS</application>.</para>
</note>
Μπορείτε να ελέγξετε το αρχείο <filename>cfg.pm</filename> για να
δείτε ποιές άλλες παραμέτρους μπορείτε να αλλάξετε, αλλά οι παραπάνω
είναι οι πιο συνήθεις επιλογές.</para>
Μπορείτε να ελέγξετε το αρχείο <filename>cfg.pm</filename> για να
δείτε ποιές άλλες παραμέτρους μπορείτε να αλλάξετε, αλλά οι παραπάνω
είναι οι πιο συνήθεις επιλογές.</para>
</step>
<step>
@ -571,7 +573,7 @@
<literal>^CVSROOT/</literal>, και προσθέστε μια γραμμή που θα
περιέχει μόνο το <literal>^CVSROOT/</literal>. Αφού εγκατασταθεί
ο wrapper, μπορείτε να προσθέσετε το δικό σας header στα αρχεία
που βρίσκονται μέσα στον κατάλογο <filename>CVSROOT</filename> και
που βρίσκονται μέσα στον κατάλογο <filename role="directory">CVSROOT</filename> και
να επαναφέρετε τις γραμμές αυτές, αλλά προς το παρόν απλά θα σας
δημιουργήσουν προβλήματα όταν θα προσπαθήσετε να κάνετε commit
αργότερα.</para>
@ -606,7 +608,7 @@
</step>
<step>
<para>Προαιρετικά αφαιρέστε τους ελέγχους του FreeBSD από το αρχείο
<para>Προαιρετικά, αφαιρέστε τους ελέγχους του FreeBSD από το αρχείο
<filename>tagcheck</filename>. Μπορείτε απλά να προσθέσετε
<literal>exit 0</literal> στην αρχή του αρχείου για να
απενεργοποιήσετε όλους τους ελέγχους στο tagging.</para>
@ -614,10 +616,11 @@
<step>
<para>Το τελευταίο πράγμα που πρέπει να γίνει, είναι να
σιγουρευτείτε ότι τα commitlogs μπορούν να αποθηκευτούν. Εξ'
ορισμού αποθηκεύονται στο repository, μέσα στον φάκελο
<filename>commitlogs</filename> που είναι υποφάκελος του
<filename>CVSROOT</filename>. Αυτός ο φάκελος πρέπει να
σιγουρευτείτε ότι τα commitlogs μπορούν να αποθηκευτούν.
Τα <application>CVS</application> scripts του FreeBSD
αποθηκεύουν αυτά τα logs στον υποκατάλογο <filename role="directory">commitlogs</filename>
του καταλόγου <filename role="directory">CVSROOT</filename>.
Αυτός ο φάκελος πρέπει να
δημιουργηθεί, οπότε κάντε τα ακόλουθα:</para>
<screen>&prompt.user; <userinput>mkdir commitlogs</userinput>
@ -627,8 +630,8 @@
<para>Τώρα, αφού ελέγξετε τα πάντα προσεκτικά, θα πρέπει να κάνετε
commit τις αλλαγές σας. Φροντίστε να είστε σίγουροι ότι έχετε δώσει
στον εαυτό σας πρόσβαση στον φάκελο <filename>CVSROOT</filename> μέσα
από το αρχείο <filename>avail</filename> πριν κάνετε οτιδήποτε, εφόσων
στον εαυτό σας πρόσβαση στον φάκελο <filename role="directory">CVSROOT</filename> μέσα
από το αρχείο <filename>avail</filename> πριν κάνετε οτιδήποτε, εφόσον
στην αντίθετη περίπτωση θα κλειδώσετε τον εαυτό σας έξω. Οπότε,
φροντίστε τα πάντα να είναι όπως επιθυμείτε, και μόνο τότε δώστε τα
ακόλουθα:
@ -658,8 +661,8 @@
<title>Ειδική Εγκατάσταση του FreeBSD Project</title>
<para>Το ίδιο το FreeBSD project χρησιμοποιεί μια ελαφρώς διαφορετική
εγκατάσταση, που χρησιμοποιεί επίσης αρχεία από τον υποφάκελο
<filename>freebsd</filename> του <filename>CVSROOT</filename> που
εγκατάσταση, η οποία χρησιμοποιεί επίσης αρχεία από τον υποφάκελο
<filename role="directory">freebsd</filename> του <filename role="directory">CVSROOT</filename> που
χρησιμοποιείται στο FreeBSD. Το project χρειάζεται κάτι τέτοιο λόγω του
μεγάλου αριθμού των committers, που διαφορετικά θα έπρεπε να ανήκουν όλοι
στο ίδιο group. Έτσι, δημιουργήθηκε ένας απλός wrapper ο οποίος αφού
@ -716,18 +719,19 @@
<procedure>
<step>
<para>Διορθώστε το αρχείο <filename>access</filename> ώστε να
περιέχει μόνο το δικό σσς username.</para>
περιέχει μόνο το δικό σας username.</para>
</step>
<step>
<para>Διορθώστε το αρχείο <filename>cvswrap.c</filename> ώστε να
περιέχει το σωστό path για τη δική σας εγκατάσταση. Αυτό ορίζεται
ως μια μακροεντολή που ονομάζεται <literal>ACCESS</literal>. Θα
πρέπει επίσης να αλλάξετε και τη διεύθυνση του πραγματικού
πρέπει επίσης να αλλάξετε και το όνομα αρχείου του πραγματικού
<command>cvs</command> binary αν αυτή που υπάρχει δεν είναι η
σωστή για τη δική σας περίπτωση. Το κανονικό
<filename>cvswrap.c</filename> αναμένει να αντικαταστήσει την
εντολή cvs σε επίπεδο συστήματος, η οποία θα θα μεταφερθεί στο
<filename>cvswrap.c</filename> θεωρεί πως θα αντικαταστήσετε την
εντολή cvs σε επίπεδο συστήματος με το cvwrap, κι η αρχική εντολή
cvs θα μεταφερθεί στο
αρχείο <filename>/usr/bin/ncvs</filename>.</para>
<para>Το δικό μου αντίτυπο του αρχείου
@ -749,7 +753,7 @@
<screen>&prompt.user; <userinput>cc -o cvs cvswrap.c</userinput></screen>
<para>Στη συνέχεια εγκαταστήστε τον με τα ακόλουθα (Θα πρέπει να είστε
<para>Στη συνέχεια εγκαταστήστε το νέο cvs εκτελέσιμο ακολουθώντας τα ακόλουθα βήματα (θα πρέπει να είστε
root για το βήμα αυτό):</para>
<screen>&prompt.root; <userinput>mv /usr/bin/cvs /usr/bin/ncvs</userinput>
@ -782,7 +786,7 @@
<screen>&prompt.user; <userinput>cvs commit -f -m '<replaceable>Forced commit to test the new CVSROOT scripts</replaceable>' access</userinput></screen>
<para>Ξανά, αν αυτό αποτύχει, ελέγξτε για το αν όλα τα παραπάνω βήματα έχουν
<para>Ξανά, αν αυτό αποτύχει, ελέγξτε ότι όλα τα παραπάνω βήματα έχουν
εκτελεστεί σωστά.</para>
</sect2>
</sect1>