X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fstandards.texi;h=73885d6670b58683d2f71834e15ed7d65392fb78;hb=3f08220c1a263dfc45f6e0ce6dcee97631dd5e56;hp=1950e3cf70b763d6559a88e036622e9f298f516f;hpb=5a99f460831f7899904a267f338867eb1fca0926;p=gnulib.git diff --git a/doc/standards.texi b/doc/standards.texi index 1950e3cf7..73885d667 100644 --- a/doc/standards.texi +++ b/doc/standards.texi @@ -3,7 +3,7 @@ @setfilename standards.info @settitle GNU Coding Standards @c This date is automagically updated when you save this file: -@set lastupdate March 25, 2010 +@set lastupdate June 21, 2010 @c %**end of header @dircategory GNU organization @@ -103,7 +103,7 @@ Archives are also available there. @cindex @code{bug-standards@@gnu.org} email address @cindex Savannah repository for gnustandards -@cindex gnustandards project repository +@cindex gnustandards project repository Please send corrections or suggestions for this document to @email{bug-standards@@gnu.org}. If you make a suggestion, please include a suggested new wording for it, to help us consider the @@ -855,8 +855,10 @@ multi-column format. @node Graphical Interfaces @section Standards for Graphical Interfaces @cindex graphical user interface +@cindex interface styles +@cindex user interface styles -@cindex gtk+ +@cindex GTK+ When you write a program that provides a graphical user interface, please make it work with the X Window System and the GTK+ toolkit unless the functionality specifically requires some alternative (for @@ -867,13 +869,18 @@ functionality. (In many cases, the graphical user interface can be a separate program which invokes the command-line program.) This is so that the same jobs can be done from scripts. -@cindex corba -@cindex gnome -Please also consider providing a CORBA interface (for use from GNOME), a -library interface (for use from C), and perhaps a keyboard-driven -console interface (for use by users from console mode). Once you are -doing the work to provide the functionality and the graphical interface, -these won't be much extra work. +@cindex CORBA +@cindex GNOME +@cindex D-bus +@cindex keyboard interface +@cindex library interface +Please also consider providing a D-bus interface for use from other +running programs, such as within GNOME. (GNOME used to use CORBA +for this, but that is being phased out.) In addition, consider +providing a library interface (for use from C), and perhaps a +keyboard-driven console interface (for use by users from console +mode). Once you are doing the work to provide the functionality and +the graphical interface, these won't be much extra work. @node Command-Line Interfaces @@ -1072,7 +1079,7 @@ The non-license that is being in the public domain, The license for Python, @url{http://www.python.org/@/2.0.1/@/license.html}. @item RBSD -The revised (3-clause) BSD, compatible with the GNU GPL, +The revised (3-clause) BSD, compatible with the GNU GPL,@* @url{http://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#5}. @item X11 @@ -4184,7 +4191,7 @@ documentation. By contrast, it is ok to refer to journal articles and textbooks in the comments of a program for explanation of how it functions, even though they are non-free. This is because we don't include such -things in the GNU system even they are free---they are outside the +things in the GNU system even if they are free---they are outside the scope of what a software distribution needs to include. Referring to a web site that describes or recommends a non-free