[Antiright-devel] antiright README ACE-desktop/ACE ACE-desktop/AC...

[Jeffrey Bedard]

CVSROOT:        /sources/antiright
Module name:    antiright
Changes by:     Jeffrey Bedard <jefbed> 07/03/22 06:41:03

Modified files:
        .              : README 
        ACE-desktop    : ACE ACE.1 system.antiright system.antiright.5 
        ACE-desktop/guidl: IDE.gdl 
        doc            : INSTALL TODO 
Removed files:
        ACE-desktop    : AUTHORS 

Log message:
        Merged revisions from antiright-3-1 of documentation.
        Removed duplicate AUTHORS.  Added CVS utility buttons
        to IDE.gdl.  Added CVS_Commit to ACE.  

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/antiright/README?cvsroot=antiright&r1=1.11&r2=1.12
http://cvs.savannah.gnu.org/viewcvs/antiright/ACE-desktop/ACE?cvsroot=antiright&r1=1.30&r2=1.31
http://cvs.savannah.gnu.org/viewcvs/antiright/ACE-desktop/ACE.1?cvsroot=antiright&r1=1.2&r2=1.3
http://cvs.savannah.gnu.org/viewcvs/antiright/ACE-desktop/system.antiright?cvsroot=antiright&r1=1.5&r2=1.6
http://cvs.savannah.gnu.org/viewcvs/antiright/ACE-desktop/system.antiright.5?cvsroot=antiright&r1=1.1&r2=1.2
http://cvs.savannah.gnu.org/viewcvs/antiright/ACE-desktop/AUTHORS?cvsroot=antiright&r1=1.1&r2=0
http://cvs.savannah.gnu.org/viewcvs/antiright/ACE-desktop/guidl/IDE.gdl?cvsroot=antiright&r1=1.5&r2=1.6
http://cvs.savannah.gnu.org/viewcvs/antiright/doc/INSTALL?cvsroot=antiright&r1=1.2&r2=1.3
http://cvs.savannah.gnu.org/viewcvs/antiright/doc/TODO?cvsroot=antiright&r1=1.15&r2=1.16

Patches:
Index: README
===================================================================
RCS file: /sources/antiright/antiright/README,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
--- README      10 Mar 2007 01:45:49 -0000      1.11
+++ README      22 Mar 2007 06:41:03 -0000      1.12
@@ -1,34 +1,41 @@
-AntiRight Desktop Environment
+AntiRight Desktop Environment - README
 by Jeffrey E. Bedard
 
-README
+INTRODUCTION
 
-AntiRight is a lightwieght, scriptable GUI shell, terminal, and desktop 
enivironment for the gtk2 environment.  It provides a small and practical 
desktop environment, defined in the ACE (AntiRight Configuration Environment) 
script.
+AntiRight is a lightwieght, scriptable GUI shell, terminal, 
+and desktop enivironment for the gtk2 environment.  It provides 
+a small and practical desktop environment, defined in the 
+ACE (AntiRight Configuration Environment) script.
 
-QUICK INSTALL
+COPYING
+
+See COPYING for licensing terms.  This program is licensed under the
+GNU General Public License.  It provides no warranty nor formal claim
+of fitness for any particular purpose.
+
+
+REQUIREMENTS
 
-To build you must have a functioning gtk2 installation, pkg-config, vte, and a
-development system for C. 
+To build you must have a functioning gtk2 installation, 
+pkg-config, vte, and a development system for C. 
 
-TO INSTALL:
-(PREFIX can be specified before configure to change installation location.)
 
-./configure
-make
-su
-make install
-exit
+INSTALL
+
+See doc/INSTALL for detailed installation instructions.  
 
 
 TO RUN:
-Start a desktop session: AR
-Start the main panel: ACE
-Start the deskbar panel: ACE -A Deskbar
-Start the terminal emulator: gshterm
-Start gtkshell GUI shell: gtkshell [options]
-       (see gtkshell.1 manual page)
 
-COPYING
-See COPYING for licensing terms.  This program is licensed under the
-GNU General Public License.  It provides no warranty nor formal claim
-of fitness for any particular purpose.
+AR &                   # full desktop session
+ACE &                   # main panel
+ACE -A Deskbar &        # desktop panel
+ACE -A IDE &            # sample IDE
+ACE -A Manual_Browser   # manual browser
+ACE -A Settings         # configuration manager for ~/.antiright
+ACE Text_Editor         # text editor, configured in ~/.antiright
+ACE Browser             # configured browser
+gshterm                 # antiright's terminal program
+gtkshell               # antiright's GUI creation utility
+

Index: ACE-desktop/ACE
===================================================================
RCS file: /sources/antiright/antiright/ACE-desktop/ACE,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -b -r1.30 -r1.31
--- ACE-desktop/ACE     21 Mar 2007 23:15:07 -0000      1.30
+++ ACE-desktop/ACE     22 Mar 2007 06:41:03 -0000      1.31
@@ -51,7 +51,7 @@
 
 CVS_Commit()
 {
-       local MESSAGE="$ARSHELL -al Message: -at echo -oe Close"
+       local MESSAGE="$($ARSHELL -al Message: -at echo -oe Close)"
        if [ "$MESSAGE" != "" ]; then
                cvs commit -m "$MESSAGE"
        fi

Index: ACE-desktop/ACE.1
===================================================================
RCS file: /sources/antiright/antiright/ACE-desktop/ACE.1,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- ACE-desktop/ACE.1   2 Mar 2007 03:56:07 -0000       1.2
+++ ACE-desktop/ACE.1   22 Mar 2007 06:41:03 -0000      1.3
@@ -19,16 +19,15 @@
 The ACE script can easily be modified to change the environment, 
 greatly easing development time.
 .PP
-To start the environment, simply invoke ACE with no options.  
-A panel will appear.  On this panel one can launch the calculator, 
-the CD player, the file manager, the sticky note utility, the calendar, 
-the text editor, the load meter/system monitor, the terminal, the browser, 
-the image editor, the mail utility, the background selection utility, the 
-configuration utility, and the run dialog.  All button bindings are 
-configurable through the settings utility.  For example, one can change 
-the default browser, which is a lynx instance in an xterm, to dillo, firefox 
or 
-mozilla.  The view menu allows one to access other panels, including 
-other instances of the current panel.  The
+To start a desktop session, use ACE -A AR.
+To start only the main panel, simply invoke ACE with no options.  
+A panel will appear.  Most button bindings are 
+configurable through the 
+.I Settings 
+utility.  For example, one can change 
+the default browser to dillo, links, firefox, mozilla, or whatever you happen
+to use.
+The
 .I Administration Panel
 contains a 
 .I Secure Permissions
@@ -174,10 +173,16 @@
 Please examine the ACE file for such functions.  
 .PP
 Other options will result in the printing of usage information.  
+.SH FILES
+.TP
+.B ~/.antiright
+This is the antiright configuration file, which stores commands associated
+with desktop functionality.
 .SH AUTHORS
 Written by Jeffrey Bedard <address@hidden>.  
 .SH REPORTING BUGS
-Report bugs to <address@hidden>
+Report bugs to <address@hidden>.  See http://www.nongnu.org for access
+information pertaining to the bug database.
 .SH COPYRIGHT
 Copyright 2002-2007, Jeffrey E. Bedard
 This  is  free software; see the source for copying conditions.  There is NO 

Index: ACE-desktop/system.antiright
===================================================================
RCS file: /sources/antiright/antiright/ACE-desktop/system.antiright,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- ACE-desktop/system.antiright        21 Mar 2007 23:15:07 -0000      1.5
+++ ACE-desktop/system.antiright        22 Mar 2007 06:41:03 -0000      1.6
@@ -40,7 +40,6 @@
 File_Manager: exec rox
 Word_Processor: exec abiword
 Calculator: exec gcalctool
-Text_Editor: exec gvim
 CD_Player: ACE Terminal cdplay
 Calendar: ACE -A Calendar
 System_Monitor: nice ACE Terminal -e top
@@ -50,7 +49,6 @@
 mp3_dir:~/mp3
 mp3_player:mpg321
 Text_Editor: exec gvim
-File_Sharing: exec gtk-gnutella
 Screen: ACE Terminal -e screen -D -RR
 # This is the administration panel configuration.  
 Root_Shell: ACE Terminal -e su
@@ -70,7 +68,6 @@
 Lock_Display:exec xlock -mode blank
 deskbar_style: echo 1
 deskbar_updater: echo TRUE
-Browser:exec firefox2
 Sticky_Note: ACE -A Sticky_Note
 Panel_Items: echo Lock_Display Screen Terminal File_Manager System_Monitor 
Browser File_Sharing Text_Editor Word_Processor Image_Editor Calculator 
Sticky_Note
 Browser:exec firefox
@@ -79,6 +76,5 @@
 Deskbar_Y:echo +0
 
 # IDE-releated
-IDE_editor: vi
-IDE_cvsroot: address@hidden:/sources/antiright
+IDE_Editor: echo vi
 

Index: ACE-desktop/system.antiright.5
===================================================================
RCS file: /sources/antiright/antiright/ACE-desktop/system.antiright.5,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- ACE-desktop/system.antiright.5      3 Feb 2007 20:11:14 -0000       1.1
+++ ACE-desktop/system.antiright.5      22 Mar 2007 06:41:03 -0000      1.2
@@ -3,16 +3,30 @@
 system.antiright \- AntiRight's configuration file
 .SH DESCRIPTION
 .I system.antiright
-is a the configuration file defining the bindings for the AntiRight 
Configuration Environment.  
+is the configuration file defining the bindings for the 
+AntiRight Configuration Environment.  The format of this file is 
+that of a colon-separated name-value pairing.
+The last value that appears in the file will be used.  Because of this, a
+change history is kept, and value modification is simplistic.
+The names in the configuration file can be passed as an argument to ACE,
+which will execute the command assigned to the name.  
+.SH EXAMPLE
+Terminal: gshterm
+Browser: ACE Terminal -e lynx
+Background: echo darkslategrey
 .SH FILES
-[PREFIX]/share/antiright/system.antiright
-~/.antiright
+.TP
+.B [PREFIX]/share/antiright/system.antiright
+Default configuration file.
+.TP
+.B ~/.antiright
+Local user configuration file.
 .SH AUTHORS
 Written by Jeffrey Bedard <address@hidden>.  
 .SH REPORTING BUGS
 Report bugs to <address@hidden>
 .SH COPYRIGHT
-Copyright 2002-2004, Jeffrey E. Bedard
+Copyright 2002-2007, Jeffrey E. Bedard
 This  is  free software; see the source for copying conditions.  There is NO 
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 .SH SEE ALSO

Index: ACE-desktop/guidl/IDE.gdl
===================================================================
RCS file: /sources/antiright/antiright/ACE-desktop/guidl/IDE.gdl,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- ACE-desktop/guidl/IDE.gdl   21 Mar 2007 23:15:07 -0000      1.5
+++ ACE-desktop/guidl/IDE.gdl   22 Mar 2007 06:41:03 -0000      1.6
@@ -8,7 +8,7 @@
 option "terminal font" "Mono 12";
 option "terminal width" 80;
 option "terminal height" 24;
-add terminal "vi";
+add terminal "`ACE IDE_Editor`";
 
 option "terminal font" "Mono 10";
 option "terminal height" 8;
@@ -17,13 +17,13 @@
 option "rows" 16;
 
 add buttons
-       "cd `gtkshell -al Directory: -at echo` && ACE -A IDE & # CD",
+       "cd `gtkshell -dd` && ACE -A IDE & # CD",
        "make", 
        "make clean", 
        "make install", 
        "make test",
-       "ACE -A CVS_Commit",
-       "cvs -q -z3 up -dP # CVS_Update";
+       "gshterm -e cvs commit # CVS_Commit",
+       "gshterm -e cvs -q -z3 update -dP # CVS_Update";
 
 option "no label fill";
 add label "     TODO:     ";

Index: doc/INSTALL
===================================================================
RCS file: /sources/antiright/antiright/doc/INSTALL,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- doc/INSTALL 26 Sep 2005 21:52:04 -0000      1.2
+++ doc/INSTALL 22 Mar 2007 06:41:03 -0000      1.3
@@ -1,16 +1,15 @@
-To build you must have a functioning motif installation and a
-development system for C. You must have the motif header files
-installed. Before making and installing, edit the Makefile to reflect
-your system setup and your installation preferences.
+REQUIREMENTS
+
+In order to build, you will need a C compiler, 
+pkg-config, vte, gtk2, glib, and gmake or bsd make.
 
 TO INSTALL:
 
+Set PREFIX environment value to desired install location.
+
+./configure
 make
 su
 make install
 exit
 
-TO RUN:
-
-ACE &
-

Index: doc/TODO
===================================================================
RCS file: /sources/antiright/antiright/doc/TODO,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -b -r1.15 -r1.16
--- doc/TODO    26 Feb 2007 19:51:33 -0000      1.15
+++ doc/TODO    22 Mar 2007 06:41:03 -0000      1.16
@@ -1,8 +1,6 @@
 TODO
 ----
 
-Write gtkshell manual page, such that it reflects actual API.  
-
 Implement button selection support, where a regular expression can be
 applied to button titles for selection.  Test if it is possible to
 drag this entire selection, else compile the titles into a string for passing.

Index: ACE-desktop/AUTHORS
===================================================================
RCS file: ACE-desktop/AUTHORS
diff -N ACE-desktop/AUTHORS
--- ACE-desktop/AUTHORS 3 Feb 2007 20:11:14 -0000       1.1
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,7 +0,0 @@
-
-This desktop environment is written by Jeffrey Bedard, who can be
-reached at address@hidden .
-
-I would like to give credit to Joe Klemmer who wrote the postinstall-pak script
-  for checkinstall, which installs an AntiRight session in gdm.  He also 
provides the project's RPM packages.
-