Συνεισφέροντας στο FreeBSD

Αρκετοί άνθρωποι που σχετίζονται με το FreeBSD δεν είναι προγραμματιστές. Το έργο περιλαμβάνει συγγραφείς τεκμηρίωσης, σχεδιαστές ιστοσελίδων και ανθρώπους που το υποστηρίζουν. Το μόνο που χρειάζεται για να συνεισφέρει κάποιος στο έργο αυτής της ομάδας είναι η διάθεση να επενδύσει λίγο χρόνο και η θέληση για γνώση.

Στις περισσότερες από τις εργασίες που αναφέρονται εδώ χρειάζεται είτε σημαντική επένδυση χρόνου ή μία σε βάθος γνώση του πυρήνα του FreeBSD ή και τα δύο. Υπάρχουν επίσης πολλές εργασίες οι οποίες είναι ταυτόχρονα χρήσιμες και αρκετά εύκολες ακόμη και για κάποιον "hacker του σαββατοκύριακου".

Η λίστα αναφορών προβλημάτων του FreeBSD περιέχει όλες τις γνωστές αναφορές προβλημάτων και τα αιτήματα αναβάθμισης τα οποία έχουν υποβάλλει σε αυτή οι χρήστες του FreeBSD. Σε αυτή υπάρχουν εργασίες τόσο για προγραμματιστές όσο και για μη προγραμματιστές. Ένας τρόπος να βοηθήσετε την ανάπτυξη του FreeBSD είναι να διατρέξετε (μία η περισσότερες φορές) τη λίστα προβλημάτων, ψάχνοντας για κάτι που σας ενδιαφέρει. Μερικές από αυτές τις αναφορές προβλημάτων σχετίζονται με πολύ απλές εργασίες. Πολλές φορές αρκεί μία σύντομη ματιά για να επιβεβαιωθεί ότι η προτεινόμενη διόρθωση κάποιου προβλήματος είναι σωστή. Άλλες φορές οι αλλαγές που χρειάζονται είναι πιο δύσκολες ή δεν έχει βρεθεί κάποια λύση ακόμα.

Αρχίστε με τις αναφορές προβλημάτων που δεν έχουν εκχωρηθεί σε κάποιον άλλον. Αν η αναφορά είναι καταχωρημένη σε κάποιον, αλλά βλέπετε ότι είναι κάτι που μπορείτε να χειριστείτε, ειδοποιήστε με email τον υπεύθυνο της αναφοράς και ρωτήστε αν μπορείτε να δουλέψετε πάνω σ' αυτήν. Ίσως ο υπεύθυνος έχει ήδη ξεκινήσει κάποιες διορθώσεις και σας δώσει κάτι για δοκιμή ή έχει ήδη κάποιες ιδέες που μπορείτε να συζητήσετε μαζί του.

Η λίστα FreeBSD των έργων και των ιδεών για εθελοντές είναι επίσης διαθέσιμη για ανθρώπους με διάθεση να συνεισφέρουν στο έργο του FreeBSD. Η λίστα ανανεώνεται τακτικά και περιλαμβάνει αντικείμενα για ενασχόληση τόσο για προγραμματιστές όσο και για μη προγραμματιστές και παρέχει πληροφορίες για κάθε έργο.

Μια ιδέα ή πρόταση γενικού τεχνικού ενδιαφέροντος θα πρέπει να αποσταλεί στη λίστα ηλεκτρονική λίστα τεχνικών συζητήσεων του FreeBSD. Επιπλέον, άνθρωποι με ενδιαφέρον για τέτοια θέματα (αλλά και ανεκτικότητα σε μεγάλο αριθμό εισερχόμενων μηνυμάτων!) μπορούν να γραφτούν στη λίστα ηλεκτρονική λίστα τεχνικών συζητήσεων του FreeBSD. Δείτε το Εγχειρίδιο του FreeBSD για περισσότερες πληροφορίες σχετικά με αυτήν αλλά και άλλες λίστες.

Αν βρείτε κάποιο bug ή αν έχετε κάνει κάποια συγκεκριμένη αλλαγή, παρακαλούμε κάντε αναφορά χρησιμοποιώντας το πρόγραμμα send-pr(1) ή την αντίστοιχη ιστοσελίδα. Προσπαθήστε να συμπληρώσετε όλα τα πεδία της αναφοράς. Αν οι αλλαγές που κάνατε δεν ξεπερνούν τα 65KB σε μέγεθος, συμπεριλάβετε τις αλλαγές σας απευθείας στην αναφορά. Αν οι αλλαγές είναι κατάλληλες για εφαρμογή στον πηγαίο κώδικα, προσθέστε την ετικέτα [PATCH] στην περίληψη της αναφοράς. Όταν συμπεριλαμβάνετε patches, μη χρησιμοποιείτε αντιγραφή-και-επικόλληση, διότι η αντιγραφή και επικόλληση μετατρέπει συχνά τους στηλοθέτες (TAB) σε κενά και αχρηστεύει το patch. Αν τα patches είναι πολύ μεγαλύτερα από 20KB, δοκιμάστε να τα συμπιέσετε (π.χ. με το gzip(1) ή το bzip2(1)) και χρησιμοποιήστε το εργαλείο uuencode(1) για να εισάγετε τη συμπιεσμένη μορφή στην αναφορά σας.

Μετά της υποβολή μιας αναφοράς θα λάβετε επιβεβαίωση παράλληλα με έναν αριθμό αναφοράς. Κρατήστε τον αριθμό ώστε να μπορείτε να μας ενημερώνετε με πληροφορίες σχετικά με το πρόβλημα στέλνοντας mail στο bug-followup@FreeBSD.org. Χρησιμοποιήστε τον αριθμό της αναφοράς σας στο θέμα του μηνύματος, π.χ. "Re: kern/3377". Επιπρόσθετες πληροφορίες για οποιοδήποτε αναφορά προβλήματος θα πρέπει να υποβάλλονται με τον παραπάνω τρόπο.

Εάν δε λάβετε επιβεβαίωση εγκαίρως (3 μέρες ως μια βδομάδα, ανάλογα με τη αξιοπιστία του email) ή για κάποιο λόγο αδυνατείτε να χρησιμοποιήσετε την εντολή send-pr(1), μπορείτε να απευθυνθείτε σε κάποιον προκειμένου να την αρχειοθετήσει για εσάς στέλνοντας mail στη ηλεκτρονική λίστα αναφορών προβλημάτων του FreeBSD.

Δείτε επίσης αυτό το άρθρο σχετικά με το πώς να γράφετε καλές αναφορές προβλημάτων.

Οι αλλαγές στην τεκμηρίωση επιβλέπονται από την ηλεκτρονική λίστα ομάδας τεκμηρίωσης του FreeBSD. Για πλήρεις οδηγίες σχετικά με τον τρόπο που μπορείτε να συνεισφέρετε στην τεκμηρίωση του FreeBSD, δείτε τον Οδηγό τεκμηρίωσης του FreeBSD. Στείλτε τα καινούρια σας κείμενα ή τις αλλαγές σας (ακόμη και μικροδιορθώσεις είναι πάντα καλοδεχούμενες) χρησιμοποιώντας την εντολή send-pr(1) όπως περιγράφετε στο Αναφορές προβλήματος και γενικές επεξηγηματικές παρατηρήσεις-σχόλια.

Μία προσθήκη ή αλλαγή στον υπάρχοντα κώδικα είναι κατά κάποιο τρόπο περίτεχνη υπόθεση και εξαρτάται αρκετά από τον βαθμό της ενημέρωσης που έχετε με την τρέχουσα κατάσταση της ανάπτυξης του FreeBSD. Υπάρχει μια ειδική συνεχώς αναπτυσσόμενη έκδοση του FreeBSD γνωστή ως "FreeBSD-CURRENT" η οποία είναι διαθέσιμη με διάφορους τρόπους για την ευκολία των προγραμματιστών που δραστηριοποιούνται ενεργά στην ανάπτυξη του συστήματος. Δείτε το Εγχειρίδιο του FreeBSD για περισσότερες πληροφορίες σχετικά με το που θα βρείτε και πώς μπορείτε να χρησιμοποιήσετε το FreeBSD-CURRENT.

Δουλεύοντας από παλιότερο κώδικα δυστυχώς σημαίνει ότι οι αλλαγές σας μπορεί μερικές φορές να είναι αρκετά ξεπερασμένες ή να αποκλίνουν πολύ, οπότε να δυσκολεύει κάπως η ενσωμάτωσή τους στο FreeBSD. Ρίσκα σαν γι' αυτά μπορούν να ελαχιστοποιηθούν κάπως με την συμμετοχή στις λίστες ηλεκτρονική λίστα ανακοινώσεων του FreeBSD και ηλεκτρονική λίστα της έκδοσης FreeBSD-CURRENT, στις οποίες διεξάγονται συζητήσεις για την τρέχουσα κατάσταση του συστήματος.

Αφού εξασφαλίσετε κάπως ένα σχετικά ενημερωμένο αντίγραφο του πηγαίου κώδικα ως βάση για τις αλλαγές σας, το επόμενο βήμα είναι να δημιουργήσετε diffs για αποστολή στην ομάδα ανάπτυξης του FreeBSD. Αυτό γίνεται με την εντολή diff(1).

Το προτιμώμενο format του diff(1) για την υποβολή patches είναι η ενοποιημένη μορφή εξόδου (unified diff), που δημιουργείται από την εντολή diff -u. Μια μικρή εξαίρεση είναι τα τα patches που αλλάζουν μεγάλα κομμάτια κώδικα, ουσιαστικά αντικαθιστώντας τα σχεδόν με μια καινούρια έκδοση. Για τέτοιες αλλαγές μπορεί να είναι πιο ευανάγνωστη η μορφή εξόδου που δημιουργείται από την εντολή diff -c.

Για παράδειγμα το:

ή το

θα δημιουργήσει ένα σετ από context diffs για τον κώδικα του συγκεκριμένου αρχείου ή της ιεραρχίας καταλόγων.

Ομοίως το,

ή το

θα κάνει το ίδιο, αλλά θα παράγει diff ενοποιημένη μορφή.

Δείτε τη βοήθεια του εργαλείου diff(1) για περισσότερες λεπτομέρειες.

Από τη στιγμή που έχετε κάποια diffs, (τα οποία μπορείτε να ελέγξετε με την εντολή patch(1)), θα πρέπει να τα υποβάλλετε για ενσωμάτωση στο FreeBSD. Χρησιμοποιήστε το πρόγραμμα send-pr(1), όπως περιγράφετε στο κείμενο Αναφορές προβλήματος και γενικές επεξηγηματικές παρατηρήσεις-σχόλια. Μη στέλνετε μόνο ένα μήνυμα με τα patches στη ηλεκτρονική λίστα τεχνικών συζητήσεων του FreeBSD αλλιώς θα χαθούν! Σας ευχαριστούμε προκαταβολικά για οποιαδήποτε προσφορά κώδικα (το έργο ανάπτυξης του FreeBSD είναι εθελοντική προσπάθεια που βασίζεται ακριβώς σε τέτοιες προσφορές!). Επειδή είμαστε απασχολημένοι, μπορεί να μη χειριστούμε την αίτηση για αλλαγή αμέσως, ωστόσο μέχρι να το κάνουμε αυτό, θα παραμείνει στην βάση αναφορών. Θυμηθείτε να επισημάνετε την υποβολή σας με την ετικέτα [PATCH] στην περίληψη της αναφοράς.

Αν νομίζετε ότι χρειάζεται (π.χ. έχετε προσθέτει, αφαιρέσει ή μετονομάσει κάποια αρχεία), χρησιμοποιείστε το εργαλείο tar για να πακετάρετε τις αλλαγές σας, και το εργαλείο uuencode(1) για να τις ενσωματώσετε στην αναφορά που θα στείλετε. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε το εργαλείο shar(1) αντί για το tar(1).

Αν η φύση των αλλαγών που θέλετε να κάνετε είναι κάπως ευαίσθητη, π.χ. αν δεν είστε σίγουροι για τα πνευματικά δικαιώματα και τη διανομή των αλλαγών ή αν απλά δεν είστε έτοιμοι να δώσετε στη δημοσιότητα κάποιες αλλαγές χωρίς ένα review ακόμα, τότε είναι καλύτερα να στείλετε τις αλλαγές σας απευθείας στην ομάδα core του FreeBSD αντί να τις προωθήσετε μέσω του send-pr(1). Η ομάδα core του FreeBSD αποτελείται από ένα πολύ μικρότερο αριθμό ατόμων. Έχετε υπόψιν όμως ότι αυτή η ομάδα είναι πολύ απασχολημένη, οπότε καλό είναι να τους στέλνετε μηνύματα μόνο όταν είστε αρκετά σίγουροι ότι είναι απαραίτητο.

Κάτι τελευταίο σχετικά με τον πηγαίο κώδικα του FreeBSD. Οι σελίδες τεκμηρίωσης intro(9) και style(9) περιέχουν πληροφορίες σχετικά με το στυλ κώδικα που προτιμούμε για το FreeBSD. Πριν στείλετε σημαντικές αλλαγές στην ομάδα ανάπτυξης είναι σημαντικό να έχετε εξοικειωθεί με το στυλ που γράφουμε και, όταν είναι δυνατόν, να το ακολουθήσετε στο γράψιμο του κώδικα που θα μας στείλετε.

Στην περίπτωση μιας σχετικά μεγάλης συνεισφοράς λογισμικού στο FreeBSD και κάθε φορά που προστίθεται ένα σημαντικό καινούριο χαρακτηριστικό στο σύστημα, είναι σχεδόν πάντα απαραίτητο να είναι διαθέσιμες οι αλλαγές με τη μορφή ενός πακέτου tar ή να είναι διαθέσιμες μέσω ενός εξυπηρετητή web ή FTP. Αν δεν έχετε πρόσβαση για να ανεβάσετε τα αρχεία σε κάποιοn εξυπηρετητή web ή FTP, ρωτήστε στην κατάλληλη λίστα ηλεκτρονικού ταχυδρομείου του FreeBSD και κάποιος άλλος μπορεί να φιλοξενήσει τα αρχεία για σας.

Το ευαίσθητο θέμα των πνευματικών δικαιωμάτων και των αδειών χρήσης είναι το επόμενο πράγμα που παίζει μεγάλο ρόλο, ιδιαίτερα για μεγάλα έργα λογισμικού. Οι άδειες χρήσης που είναι αποδεκτές για κώδικα που ενσωματώνεται στο FreeBSD είναι οι παρακάτω:

Οι συνεισφορές κώδικα με οποιαδήποτε άλλη άδεια πρέπει να περάσουν από πολύ προσεκτικό έλεγχο πριν αποφασίσουμε αν υπάρχει λόγος να ενσωματωθούν με το FreeBSD. Οι συνεισφορές με ιδιαίτερα αυστηρούς εμπορικούς περιορισμούς απορρίπτονται συνήθως χωρίς πολύ σκέψη, αλλά οι δημιουργοί των αλλαγών ή του συγκεκριμένου κώδικα μπορούν πάντα να διανέμουν τις αλλαγές τους μέσα από τα δικά τους κανάλια διανομής και επικοινωνίας.

Για να ορίσετε ότι κάποιο δικό σας έργο πηγαίου κώδικα διανέμεται με τους όρους μιάς άδειας "τύπου BSD" μπορείτε να συμπεριλάβετε στην αρχή των αρχείων πηγαίου κώδικα το παρακάτω κείμενο, αντικαθιστώντας το κείμενο μεταξύ των %% με τις κατάλληλες πληροφορίες:

Ένα αντίγραφο αυτού του κειμένου υπάρχει στο αρχείο /usr/shared/examples/etc/bsd-style-copyright, οπότε μπορείτε να το αντιγράφετε από εκεί κάθε φορά που χρειάζεται.

Κάθε δωρεά που μπορείτε να κάνετε στο έργο του FreeBSD είναι ευπρόσδεκτη. Ακόμα και η πιο μικρή προσφορά μπορεί να έχει μεγάλη σημασία για ένα έργο το οποίο βασίζεται στην εθελοντική εργασία, όπως το δικό μας. Ειδικά οι προσφορές σε υλικό είναι πολύ σημαντικές, αφού έτσι μας δίνεται η δυνατότητα να επεκτείνουμε την υποστήριξη του FreeBSD για το υλικό αυτό - κάτι που μπορεί να μην είναι εύκολο αν πρέπει να αγοράσουμε κάθε κομμάτι υλικού μόνοι μας.