/[gli]/trunk/README
Gentoo

Contents of /trunk/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1832 - (hide annotations) (download)
Sun Mar 25 22:15:41 2007 UTC (7 years, 7 months ago) by codeman
File size: 2957 byte(s)
copying the overhaul branch into trunk.

1 esammer 4 Gentoo Linux Installer README
2     Copyright 2004 Gentoo Technologies, Inc.
3 esammer 46 $Header: /var/cvsroot/gentoo/src/installer/README,v 1.3 2004/04/11 21:47:21 esammer Exp $
4 esammer 4
5 esammer 19 The Gentoo Linux Installer (or GLI) is a consistent installer for all
6     architectures supported by Gentoo itself. The final installer will support
7     multiple UIs including plain text, curses, GTK, Qt, and others.
8    
9     Project pages and information:
10    
11     http://www.gentoo.org/proj/en/releng/installer/
12    
13     Reporting bugs:
14    
15     Please file all bug reports at http://bugs.gentoo.org
16     Please make sure you select "Gentoo Linux" as the product and "GLI" as the
17     component. (GLI is for Gentoo Linux Installer.) Make sure you include as much
18     relevant information as possible about your system.
19    
20     Contacting Us:
21    
22     Most of the time, the developers can be found on irc.freenode.net in the
23     #gentoo-installer channel. Come by and chat.
24    
25     There is also an official mailing list for discussion. Send an email to
26     gentoo-installer@lists.gentoo.org to subscribe. Follow the directions you
27     receive back.
28    
29 esammer 46 Coding Guidelines:
30    
31     If you'd like to contribute code, we ask that certain coding guidelines be
32     followed to keep all code consistent, neat, and clean. These are not to
33     punish or be overly controlling, but to promote readability and overall
34     consistency. The following are the current "rules of engagement" when
35     dealing with code:
36    
37     1. Class names should be StudlyCaps using complete words such as
38     InstallProfile, or ClientConfiguration. All classes should be "new style"
39     Python classes (inherit from "object").
40    
41     2. All source files should be in the form of GLISomeClassName.py. This is
42     to keep our modules and classes separate.
43    
44     3. All source files should have a header like that of
45     src/GLIInstallProfile.py which is already in the tree.
46    
47     4. All instance variables should be "private" such as _filename or
48     _username and use underscores ('_') to separate words such as
49     _chroot_directory or _syslog_daemon. All instance variables should be
50     nouns (check exceptions with devs in #gentoo-installer).
51    
52     5. Methods should use the same capitalization and word separation as
53     instance variables. If a method is an accessor (gets or sets a specific
54     instance variable) it should use the get_<instance var name> and
55     set_<instance var name> naming. All method names should be verbs (check
56     exceptions with devs in #gentoo-installer).
57    
58     6. Public instance variables are bad. Please encapsulate all code.
59    
60     7. Instance variables should be defined (or bound) as class scope and
61     initialized in __init__ as appropriate. Please keep all dynamic and
62     decentralized definitions to a minimum.
63    
64     8. Keep abbreviations to a minimum - what is obvious to you is not to
65     everyone else. Please be aware that not all developers and users are
66     native English speakers.
67    
68     9. When in doubt, check with the other devs in #gentoo-installer.
69    
70     10. There are always exceptions to the rules, but please do not assume
71     your code is the exception. New guidelines will be listed here.

Properties

Name Value
svn:eol-style native

  ViewVC Help
Powered by ViewVC 1.1.20