[Monotone-commits-diffs] net.venge.monotone: 3bf5cb27637aab8b76b1e64278ab35365b5efdcf

[code]

revision:            3bf5cb27637aab8b76b1e64278ab35365b5efdcf
date:                2011-02-21T23:48:27
author:              Richard Levitte <address@hidden>
branch:              net.venge.monotone
changelog:
* src/util/mtnopt.1: New manpage for the mtnopt utility script.
* Makefile.am (man1_MANS): Add it here.

manifest:
format_version "1"

new_manifest [a41c16fc08af4def99137b2bb6ead379522ed8eb]

old_revision [d936d8b57b9d7f91b12dccf0393571d5a4f0dfb9]

add_file "src/util/mtnopt.1"
 content [8e24a1cafa100a7d6681cc19e30ee82a4cf517f4]

patch "Makefile.am"
 from [a9f9379d9bdb196cc174abef4a16a02a865ab75e]
   to [afb4061158473f26fc5e1b809cc27d3cdd6077a1]
============================================================
--- Makefile.am	a9f9379d9bdb196cc174abef4a16a02a865ab75e
+++ Makefile.am	afb4061158473f26fc5e1b809cc27d3cdd6077a1
@@ -831,7 +831,7 @@ distcheck-base.hh:
                        $(UNIX_PLATFORM_SOURCES) $(WIN32_PLATFORM_SOURCES) \
                        src/win32/main.cc src/unix/main.cc)
 
-man1_MANS = mtn.1 extra/bin/mtn-cleanup.1
+man1_MANS = mtn.1 src/util/mtnopt.1 extra/bin/mtn-cleanup.1
 
 # All local variants of automake-supported targets here, depending on all
 # the things we want to do.  This is to support multiple things to do in
============================================================
--- /dev/null	
+++ src/util/mtnopt.1	8e24a1cafa100a7d6681cc19e30ee82a4cf517f4
@@ -0,0 +1,95 @@
+.TH MTNOPT 1 2011-02-22 monotone monotone
+.SH NAME
+mtnopt \- generate shell variables from monotone workspace options
+.SH SYNOPSIS
+.B mtnopt
+.RB [\| \-s \||\| \-c \||\| \-v \|]
+.RB [\| \-d 
+.IR dir \|]
+.RB [\| \-k
+.IR keys \|]
+.br
+.B mtnopt -h
+.br
+.SH DESCRIPTION
+.B mtnopt
+prints shell variable assignments for each value in the file of
+monotone workspace options,
+.IR _MTN/options ,
+in the current directory. For instance, if
+.I _MTN/options
+contained this text:
+.IP
+\f(CWdatabase "/home/user/src/monotone.mtn"\fP
+.br
+\f(CW  branch "net.venge.monotone"\fP
+.br
+\f(CW  keydir "/home/user/.monotone/keys"\fP
+.PP
+.B mtnopt
+would print:
+.IP
+\f(CWMTN_database="/home/user/src/monotone.mtn";\fP
+.br
+\f(CWMTN_branch="net.venge.monotone";\fP
+.br
+\f(CWMTN_keydir="/home/user/.monotone/keys";\fP
+.PP
+By default,
+.B mtnopt 
+attempts to guess appropriate syntax from the value of the
+.B SHELL
+environment variable.  This can be overridden with the 
+.B \-s
+and 
+.B \-c
+command\(hyline options.
+.SH OPTIONS
+.TP
+.B \-s
+Print variable assignments in 
+.BR sh (1)
+syntax.
+.TP
+.B \-c
+Print variable assignments in 
+.BR csh (1)
+syntax.
+.TP
+.B \-v
+Print only the values, with no indication of the corresponding option keys.
+.TP
+.BI \-d\  directory
+Look for 
+.I _MTN/options
+in
+.IR directory ,
+rather than in the current directory.
+.TP
+.BI \-k\  keys
+Print assignments for only those options that match the
+.BR egrep (1)
+regular _expression_
+.IR keys .
+.TP
+.B \-h
+Print a help message and exit.
+.SH BUGS
+.B mtnopt
+only looks in the current directory for the
+.I _MTN
+directory, so it will fail in a subdirectory of a workspace.
+.PP
+.B mtnopt
+should be aware of the set of possible options, rather than blindly
+printing whatever is in
+.IR _MTN/options .
+.PP
+The behavior when there is no
+.I _MTN/options
+file to be found is less than helpful.
+.SH SEE ALSO
+.BR mtn (1),
+.BR egrep (1),
+.BR sh (1),
+.BR csh (1)