[yum-cvs] yum/docs yum-shell.8, NONE, 1.1 Makefile, 1.2, 1.3 yum.8, 1.32, 1.33

[Seth Vidal]

Update of /home/groups/yum/cvs/yum/docs
In directory login:/tmp/cvs-serv17507/docs

Modified Files:
	Makefile yum.8 
Added Files:
	yum-shell.8 
Log Message:
shell.py: support shell-like quoting of arguments - especially useful for
          group names
docs/yum-shell.8: document the yum shell
docs/yum.8: point to the yum shell docs
docs/Makefile: install the yum-shell man page.



--- NEW FILE yum-shell.8 ---
.\" yum shell - Yum shell interface
.TH "yum" "8" "2005 Aug 5" "Seth Vidal" ""
.SH "NAME"
yum \- Yellowdog Updater Modified shell
.SH "SYNOPSIS"
\fByum shell\fP [filename]
.SH "DESCRIPTION"
.PP 
\fByum\fP includes an interactive shell for conducting multiple commands or
sets of commands during a single execution of yum. These commands can be
issued manually or passed to yum from a file. The commands are much the same
as the normal yum command line options. See here \fIyum(8)\fP for that
information. There are a few additional commands documented below.

.PP
.IP "\fBconfig\fP"
   [argument] [value] 
   args: debuglevel, errorlevel, obsoletes, gpgcheck, assumeyes, exclude
     If no value is given it prints the current value\&. 
     If value is given it sets that value\&.
.IP
.IP "\fBrepo\fP"
   [argument] [option]
     list: lists repositories and their status
     enable: enable repositories. option = repository id 
     disable: disable repositories. option = repository id 
.IP
.IP "\fBtransaction\fP"
   [argument]
     list: lists the contents of the transaction 
     reset: reset (zero-out) the transaction 
     solve: run the dependency solver on the transaction
     run: run the transaction 

.PP 
.SH "Examples"
The following are examples of using the yum shell\&.
.IP
 list available packagename*
 groupinfo 'Some Group'
 install foo
 remove bar
 update baz
 run

That will list available packages matching the glob 'packagename*'.
It will return information on the group 'Some Group'
It will then queue the following commands into  the transaction: install
foo, remove bar, update baz. Then the 'run' command will resolve dependencies
for the transaction commands and run the transaction.
.PP 
.SH "SEE ALSO"
.nf
.I yum (8)
http://linux.duke.edu/yum/
.fi 

.PP 
.SH "AUTHORS"
.nf 
See the Authors file included with this program.
.fi 

.PP 
.SH "BUGS"
There of course aren't any bugs, but if you find any, they should be sent
to the mailing list: yum at lists.linux.duke.edu or filed in bugzilla.
.fi

Index: Makefile
===================================================================
RCS file: /home/groups/yum/cvs/yum/docs/Makefile,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Makefile	13 Oct 2004 05:36:58 -0000	1.2
+++ Makefile	5 Aug 2005 05:41:07 -0000	1.3
@@ -7,5 +7,6 @@
 install:
 	mkdir -p $(DESTDIR)/usr/share/man/man{5,8}
 	install -m 644 yum.8 $(DESTDIR)/usr/share/man/man8/yum.8
+	install -m 644 yum-shell.8 $(DESTDIR)/usr/share/man/man8/yum-shell.8
 	install -m 644 yum-arch.8 $(DESTDIR)/usr/share/man/man8/yum-arch.8
 	install -m 644 yum.conf.5 $(DESTDIR)/usr/share/man/man5/yum.conf.5

Index: yum.8
===================================================================
RCS file: /home/groups/yum/cvs/yum/docs/yum.8,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- yum.8	24 Jul 2005 23:53:41 -0000	1.32
+++ yum.8	5 Aug 2005 05:41:07 -0000	1.33
@@ -1,5 +1,5 @@
 .\" yum - Yellowdog Updater Modified
-.TH "yum" "8" "2005 Jan 9" "Seth Vidal" ""
+.TH "yum" "8" "2005 Aug 05" "Seth Vidal" ""
 .SH "NAME"
 yum \- Yellowdog Updater Modified
 .SH "SYNOPSIS"
@@ -118,7 +118,7 @@
 .IP 
 .IP "\fBshell\fP"
 Is used to enter the 'yum shell', when a filename is specified the contents of
-that file is executed in yum shell mode. 
+that file is executed in yum shell mode. See \fIyum-shell(8)\fP for more info
 .IP
 .IP "\fBresolvedep\fP"
 Is used to list packages providing the specified dependencies, at most one