diff --git a/bin/Makefile.am b/bin/Makefile.am index 290b11ca1..c75f388c7 100644 --- a/bin/Makefile.am +++ b/bin/Makefile.am @@ -12,8 +12,6 @@ bin_SCRIPTS = fvwm-perllib \ fvwm-menu-desktop \ FvwmCommand -man_MANS = fvwm-menu-xlock.1 fvwm-menu-directory.1 fvwm-perllib.1 - LDADD = -L$(top_builddir)/libs $(X_LIBS) -lfvwm3 $(xpm_LIBS) $(Xcursor_LIBS) \ $(X_PRE_LIBS) -lXext -lX11 -lm $(X_EXTRA_LIBS) $(Xrender_LIBS) \ $(Xcursor_LIBS) $(png_LIBS) $(rsvg_LIBS) $(XRandR_LIBS) \ @@ -24,43 +22,11 @@ AM_CPPFLAGS = -I$(top_srcdir) $(xpm_CFLAGS) $(X_CFLAGS) $(png_CFLAGS) \ configdir = @FVWM_DATADIR@ config_DATA = fvwm-menu-desktop-config.fpl -EXTRA_DIST = fvwm-menu-desktop-config.fpl $(man_MANS) FvwmPrompt +EXTRA_DIST = fvwm-menu-desktop-config.fpl FvwmPrompt dist-hook: rm -f $(distdir)/FvwmPrompt/FvwmPrompt -## The long generation for *.1 is to make both pod2man and 'make -j' happy. - -_fvwm-menu-xlock.1: fvwm-menu-xlock - @TMP=tmp-$$$$ NAME=fvwm-menu-xlock && (\ - mkdir $$TMP && \ - cp $$NAME.in $$TMP/$$NAME && \ - pod2man --center "Fvwm Utilities" --release "@VERSION@@VERSIONINFO@" \ - --name $$NAME $$TMP/$$NAME >$$TMP/$$NAME.1 && \ - mv $$TMP/$$NAME.1 .; \ - rm -rf $$TMP) - -_fvwm-menu-directory.1: fvwm-menu-directory - @TMP=tmp-$$$$ NAME=fvwm-menu-directory && (\ - mkdir $$TMP && \ - cp $$NAME.in $$TMP/$$NAME && \ - pod2man --center "Fvwm Utilities" --release "@VERSION@@VERSIONINFO@" \ - --name $$NAME $$TMP/$$NAME >$$TMP/$$NAME.1 && \ - mv $$TMP/$$NAME.1 .; \ - rm -rf $$TMP) - -_fvwm-perllib.1: fvwm-perllib - @TMP=tmp-$$$$ NAME=fvwm-perllib && (\ - mkdir $$TMP && \ - cp $$NAME.in $$TMP/$$NAME && \ - pod2man --center "Fvwm Utilities" --release "@VERSION@@VERSIONINFO@" \ - --name $$NAME $$TMP/$$NAME >$$TMP/$$NAME.1 && \ - mv $$TMP/$$NAME.1 .; \ - rm -rf $$TMP) - -regenerate: \ - _fvwm-menu-xlock.1 - ## Create compatibility symlinks if available fvwm_root_name =`echo "fvwm-root" | "$(SED)" -e "${transform}"` diff --git a/bin/fvwm-menu-directory.1 b/bin/fvwm-menu-directory.1 deleted file mode 100644 index 267126437..000000000 --- a/bin/fvwm-menu-directory.1 +++ /dev/null @@ -1,330 +0,0 @@ -.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.02) -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" Escape single quotes in literal strings from groff's Unicode transform. -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.ie \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.el \{\ -. de IX -.. -.\} -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "fvwm-menu-directory 1" -.TH fvwm-menu-directory 1 "2009-03-22" "2.5.28 (from cvs)" "Fvwm Utilities" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.if n .ad l -.nh -.SH "NAME" -fvwm\-menu\-directory \- builds a directory browsing menu for fvwm -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -\&\fBfvwm-menu-directory\fR [ \fB\-\-help\fR|\fB\-h\fR|\fB\-?\fR ] [ \fB\-\-version\fR|\fB\-V\fR ] [ \fB\-\-name\fR|\fB\-na\fR \s-1NAME\s0 ] [ \fB\-\-title\fR|\fB\-t\fR \s-1NAME\s0 ] [ \fB\-\-item\fR|\fB\-it\fR \s-1NAME\s0 ] [ \fB\-\-icon\-title\fR|\fB\-icon\-t\fR \s-1XPM\s0 ] [ \fB\-\-icon\-dir\fR|\fB\-icon\-d\fR \s-1XPM\s0 ] [ \fB\-\-icon\-file\fR|\fB\-icon\-f\fR \s-1XPM\s0 ] [ \fB\-\-icon\-app\fR|\fB\-icon\-a\fR \s-1XPM\s0 ] [ \fB\-\-wm\-icons\fR ] [ \fB\-\-dir\fR|\fB\-d\fR \s-1NAME\s0 ] [ \fB\-\-order\fR|\fB\-o\fR \s-1NUM\s0 ] [ \fB\-\-[no]all\fR|\fB\-a\fR ] [ \fB\-\-[no]links\fR|\fB\-l\fR ] [ \fB\-\-xterm\fR|\fB\-x\fR \s-1CMD\s0 ] [ \fB\-\-exec\-title\fR|\fB\-exec\-t\fR \s-1CMD\s0 ] [ \fB\-\-exec\-file\fR|\fB\-exec\-f\fR \s-1CMD\s0 ] [ \fB\-\-exec\-app\fR|\fB\-exec\-a\fR [\s-1CMD\s0] ] [ \fB\-\-command\-title\fR|\fB\-command\-t\fR \s-1CMD\s0 ] [ \fB\-\-command\-file\fR|\fB\-command\-f\fR \s-1CMD\s0 ] [ \fB\-\-command\-app\fR|\fB\-command\-a\fR \s-1CMD\s0 ] [ \fB\-\-[no]reuse\fR|\fB\-r\fR ] [ \fB\-\-[no]check\-subdirs\fR|\fB\-ch\fR ] [ \fB\-\-special\-dirs\fR|\fB\-s\fR [\s-1VALUE\s0] ] [ \fB\-\-[no]memory\-for\-speed\fR|\fB\-mem\fR ] [ \fB\-\-menu\-style\fR|\fB\-men\fR \s-1NAME\s0 ] [ \fB\-\-func\-name\fR|\fB\-f\fR \s-1NAME\s0 ] -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -A perl script which provides an output to read in with PipeRead to build an fvwm menu containing a directory listing. Almost everything can be configured. -.SH "HINTS" -.IX Header "HINTS" -The title item with its own attached action is usually added to the menu. This may be used to define an action for the directory for which the menu is built, such as starting a terminal in this directory (the default). However, this may annoy some users. To disable the title action use \fB\-\-command\-title\fR "", to remove the title completely use \fB\-\-title\fR "". -.SH "OPTIONS" -.IX Header "OPTIONS" -.IP "\fB\-\-help\fR" 4 -.IX Item "--help" -show the usage and exit -.IP "\fB\-\-version\fR" 4 -.IX Item "--version" -show version and exit -.IP "\fB\-\-name\fR name" 4 -.IX Item "--name name" -menu name, used only with \-\-reuse, default is MenuBrowser -.IP "\fB\-\-title\fR title" 4 -.IX Item "--title title" -menu title format, default is '%*\-40p' \- last 40 characters of the current full path. \s-1TAB\s0 can be specified as '\et', but in .fvwm2rc you should specify a double backslash or a real \s-1TAB\s0. -.Sp -Format specifiers: \f(CW%d\fR \- the current directory name \f(CW%p\fR \- the current directory full path -.Sp -These specifiers can receive an optional integer size, positive for right adjusted string or negative for left adjusted, example: \f(CW%8x\fR; and optional *num or *\-num, which means to leave only the first or last (if minus) num of chars, the num must be greater than 3, since the striped part is replaced with \*(L"...\*(R", example: %*30x. Both can be combined: %\-10*\-20x, this instructs to get only the 20 last characters, but if the length is less then 10 \- to fill with up to 10 spaces on the right. -.IP "\fB\-\-item\fR format" 4 -.IX Item "--item format" -menu item format, default is '%n'. \s-1TAB\s0 and width modifiers for \f(CW%n\fR, \f(CW%N\fR and \f(CW%s\fR can be specified as described in \fB\-\-title\fR above. Note, specifying a non default format slows the script. -.Sp -Format specifiers: -.Sp -.Vb 7 -\& %n \- file/dir name (without the path) -\& %N \- file/dir name (full with the path) -\& %d \- file/dir date (yyyy\-mm\-dd HH:MM:SS) -\& %D \- file/dir date (yyyy\-mm\-dd) -\& %s \- file/dir size (in bytes) -\& %t \- file/dir type (File|Dir |Link|Sock|Blck|Char|Pipe) -\& %T \- file/dir type (F|D|L|S|B|C|P) -.Ve -.Sp -Example: \-\-title '%*\-40p\etDate, Type\etSize' \-\-item '%*40n\et%d \f(CW%t\fR\et%s' -.IP "\fB\-\-icon\-title\fR icon" 4 -.IX Item "--icon-title icon" -menu title icon, default is none -.IP "\fB\-\-icon\-dir\fR icon" 4 -.IX Item "--icon-dir icon" -menu dir icon, default is none -.IP "\fB\-\-icon\-file\fR icon" 4 -.IX Item "--icon-file icon" -menu file icon, default is none -.IP "\fB\-\-icon\-app\fR icon" 4 -.IX Item "--icon-app icon" -menu application icon, default is none -.IP "\fB\-\-wm\-icons\fR" 4 -.IX Item "--wm-icons" -define icon names suitable for use with wm-icons package. Currently this is equivalent to: \-\-icon\-title menu/folder\-open.xpm \-\-icon\-item menu/file.xpm \-\-icon\-dir menu/folder.xpm \-\-icon\-app menu/utility.xpm. -.IP "\fB\-\-dir\fR dir" 4 -.IX Item "--dir dir" -starting dir, default is ${\s-1HOME\-\s0.} -.IP "\fB\-\-order\fR number" 4 -.IX Item "--order number" -in the range (\-6 .. 6), default is 5: -.Sp -.Vb 3 -\& 1 \- do not sort, 2 \- dirs first, 3 \- files first -\& 4 \- sort by name, 5 \- dirs first, 6 \- files first -\& Negative number represents reverse order. -.Ve -.IP "\fB\-\-[no]all\fR" 4 -.IX Item "--[no]all" -show hidden files, like in 'ls \-A', default is \-\-noall -.IP "\fB\-\-[no]links\fR" 4 -.IX Item "--[no]links" -follow linked directories, default is \-\-nolinks -.IP "\fB\-\-xterm\fR command" 4 -.IX Item "--xterm command" -X terminal call, default is 'xterm \-e' -.IP "\fB\-\-exec\-title\fR command" 4 -.IX Item "--exec-title command" -an fvwm Exec command on directory title (usually the shell), default is ${SHELL\-/bin/sh}. '\-' means no Exec command, i.e. Nop. If the command is not started with '^' X terminal call is prepended. The command is started in the currently browsed directory. -.IP "\fB\-\-exec\-file\fR command" 4 -.IX Item "--exec-file command" -an fvwm Exec command on regular files, default is ${EDITOR\-vi}. '\-' means no Exec command, i.e. Nop. If the command is not started with '^' X terminal call is prepended. The actual file name is appended to the command. -.IP "\fB\-\-exec\-app\fR [command]" 4 -.IX Item "--exec-app [command]" -an fvwm Exec command on +x files, default is '\-', which means the same command as on regular files. If no command is given, it is assumed to be empty \- simply run the +x file. If the command is not started with '^' X terminal call is prepended. The actual file name is appended to the command. -.IP "\fB\-\-command\-title\fR command" 4 -.IX Item "--command-title command" -an fvwm command to execute on title. If this option is not given (or command is '\-'), the \f(CW\*(C`\-\-exec\-title\*(C'\fR is used instead. In the command, \f(CW%d\fR is substituted with the full directory path. -.Sp -In fact, \fI\-\-exec\-title=tcsh\fR is equivalent to \fI\-\-command\-title='Exec cd \*(L"%d\*(R"; xterm \-e tcsh'\fR -.Sp -The empty value disables the title action. -.IP "\fB\-\-command\-file\fR command" 4 -.IX Item "--command-file command" -an fvwm command to execute on regular files. If this option is not given (or command is '\-'), the \f(CW\*(C`\-\-exec\-file\*(C'\fR is used instead. In the command, \f(CW%f\fR is substituted with the full file path. -.Sp -In fact, \-\-exec\-file=vi is equivalent to \-\-command\-file='Exec xterm \-e vi \*(L"%f\*(R"' -.IP "\fB\-\-command\-app\fR command" 4 -.IX Item "--command-app command" -an fvwm command to execute on +x files. If this option is not given (or command is '\-'), the \f(CW\*(C`\-\-command\-app\*(C'\fR is used instead. In the command, \f(CW%f\fR is substituted with the full file path. -.Sp -In fact, \-\-exec\-app=^exec is equivalent to \-\-command\-app='Exec exec \*(L"%f\*(R"' -.IP "\fB\-\-[no]reuse\fR" 4 -.IX Item "--[no]reuse" -no pop-up menus, reuse the same menu, default is \-\-noreuse. When you specify this option the Menu action is used, not Popup. Also, the \-\-name parameter is not ignored, and \-\-dir parameter is ignored if there is ~/.fvwm/.fvwm\-menu\-directory.dir file. This file is only created or used with this option specified, it is the only solution for the current fvwm menu state. -.IP "\fB\-\-[no]check\-subdirs\fR" 4 -.IX Item "--[no]check-subdirs" -check all subdirs for having execute (+x) permission and replace \*(L"Popup\*(R"/\*(L"Menu\*(R" command with \*(L"Nop\*(R" for these without permissions. This has a visual effect of disabling popup triangle in the subdirectory item. The default is \-\-nocheck\-subdirs, because: 1) enabling this slows a bit the script, 2) with this option enabled, if no icons used and no dir/file separate sorting used there is no way to know that the item is directory and not file. -.IP "\fB\-\-special\-dirs\fR value" 4 -.IX Item "--special-dirs value" -add .. or ~ or / special directories according to given optional value. Without with option these directories are not added. Default value if not specified is \*(L"1,2\*(R". The value is comma separated ordered special directory indexes, where 1 is parent directory, 2 is home directory, 3 is root directory. If minus is prepended to the value, special directories are added at the bottom of menu instead of top. Value \*(L"0\*(R" or any bad value is equivalent to non-specifying this option at all. -.IP "\fB\-\-[no]memory\-for\-speed\fR" 4 -.IX Item "--[no]memory-for-speed" -use speed optimization, i.e. use previously created directory menus without destroying it when closed, default is \-\-nomemory\-for\-speed -.Sp -.Vb 2 -\& Warning: speed optimization takes up a lot of memory -\& that is never free\*(Aqd again while fvwm is running. -.Ve -.IP "\fB\-\-menu\-style\fR name" 4 -.IX Item "--menu-style name" -assign MenuStyle name to the menus -.IP "\fB\-\-func\-name\fR name" 4 -.IX Item "--func-name name" -overwrite the default MissingSubmenuFunction name that is \*(L"FuncFvwmMenuDirectory\*(R" -.PP -Option parameters can be specified either using '=' or in the next argument. Short options are ok if not ambiguous: \f(CW\*(C`\-a\*(C'\fR, \f(CW\*(C`\-x\*(C'\fR, \f(CW\*(C`\-icon\-f\*(C'\fR; but be careful with short options, what is now unambiguous, can become ambiguous in the next versions. -.SH "USAGE" -.IX Header "USAGE" -Put this into your fvwm configuration file to invoke the script: -.PP -.Vb 2 -\& AddToFunc FuncFvwmMenuDirectory -\& + I PipeRead "fvwm\-menu\-directory \-d \*(Aq$0\*(Aq" -.Ve -.PP -More complex example: -.PP -.Vb 4 -\& # AddToFunc FuncFvwmMenuDirectory -\& # + I PipeRead "fvwm\-menu\-directory \-d \*(Aq$0\*(Aq \-x \*(AqEterm \-g 80x40 \-e\*(Aq \e\e -\& \-a \-l \-o 6 \-\-exec\-app \-\-exec\-title \*(Aqtcsh \-l\*(Aq \-\-exec\-file \*(Aqvim \-R\*(Aq \e\e -\& \-t \*(AqGo to: %d\*(Aq \-\-wm\-icons" -.Ve -.PP -And put this in the menu from which you want to pop-up the directory menus: -.PP -.Vb 3 -\& AddToMenu SomeMenu MissingSubmenuFunction FuncFvwmMenuDirectory -\& + "Home Directory" Popup $[HOME] -\& + "Httpd Directory" Popup /home/httpd -.Ve -.PP -Note: please use absolute path names. -.PP -It is a good idea to set the menu pop-up delay to something positive and enable busy cursor -.PP -.Vb 2 -\& MenuStyle * PopupDelayed, PopupDelay 200 -\& BusyCursor DynamicMenu True -.Ve -.PP -in your configuration file when using this script for better results. -.PP -Another interesting usage (\f(CW\*(C`\-\-reuse\*(C'\fR or \f(CW\*(C`\-r\*(C'\fR is mandatary for this): -.PP -.Vb 4 -\& AddToMenu Browser -\& + DynamicPopupAction PipeRead \e\e -\& "fvwm\-menu\-directory \-r \-na Browser \-d / \-s" -\& AddToMenu SomeMenu "My Browser" Menu Browser -.Ve -.PP -Here the \f(CW\*(C`\-\-dir\*(C'\fR parameter (starting directory) is ignored if there is ~/.fvwm/.fvwm\-menu\-directory.dir file, which you can delete. -.SH "AUTHORS" -.IX Header "AUTHORS" -Inspired on 1999\-06\-07 by Dominik Vogt . -.PP -Rewritten on 1999\-08\-05 by Mikhael Goikhman . -.SH "COPYING" -.IX Header "COPYING" -The script is distributed by the same terms as fvwm itself. See \s-1GNU\s0 General Public License for details. -.SH "BUGS" -.IX Header "BUGS" -Report bugs to fvwm\-bug@fvwm.org. diff --git a/bin/fvwm-menu-directory.in b/bin/fvwm-menu-directory.in index 39018d2fe..8083833bc 100644 --- a/bin/fvwm-menu-directory.in +++ b/bin/fvwm-menu-directory.in @@ -404,7 +404,8 @@ sub wrong_usage { __END__ # --------------------------------------------------------------------------- - +# Manpage has been moved to doc/fvwm-menu-directory.adoc. +# This is no loner used to generate the manpage. =head1 NAME fvwm-menu-directory - builds a directory browsing menu for fvwm diff --git a/bin/fvwm-menu-xlock.1 b/bin/fvwm-menu-xlock.1 deleted file mode 100644 index 8e0014326..000000000 --- a/bin/fvwm-menu-xlock.1 +++ /dev/null @@ -1,218 +0,0 @@ -.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.02) -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" Escape single quotes in literal strings from groff's Unicode transform. -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.ie \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.el \{\ -. de IX -.. -.\} -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "fvwm-menu-xlock 1" -.TH fvwm-menu-xlock 1 "2009-03-22" "2.5.28 (from cvs)" "Fvwm Utilities" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.if n .ad l -.nh -.SH "NAME" -fvwm\-menu\-xlock \- builds xlock menu definition for fvwm -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -\&\fBfvwm-menu-xlock\fR [ \fB\-\-help\fR|\fB\-h\fR|\fB\-?\fR ] [ \fB\-\-version\fR|\fB\-V\fR ] [ \fB\-\-name\fR|\fB\-n\fR name ] [ \fB\-\-title\fR|\fB\-t\fR title ] [ \fB\-\-item\fR format ] [ \fB\-\-icon\-title\fR icon ] [ \fB\-\-icon\-item\fR icon ] [ \fB\-\-special\-first\fR|\fB\-s\fR ] [ \*(-- xlock params ] -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -A simple perl script which parses xlock's output to build an fvwm menu definition of all xlock's modes. -.SH "OPTIONS" -.IX Header "OPTIONS" -.IP "\fB\-\-help\fR" 4 -.IX Item "--help" -show the help and exit -.IP "\fB\-\-version\fR" 4 -.IX Item "--version" -show the version and exit -.IP "\fB\-\-name\fR name" 4 -.IX Item "--name name" -define menu name in the following argument. Default is \*(L"XLockMenu\*(R" -.IP "\fB\-\-title\fR title" 4 -.IX Item "--title title" -define menu title in the following argument. Default is \*(L"XLock Modes\*(R". -.IP "\fB\-\-item\fR format" 4 -.IX Item "--item format" -define menu item format in the following argument, default is '%n\et(%d)'. \s-1TAB\s0 can be specified as '\et', but in .fvwm2rc you should specify a double backslash or a real \s-1TAB\s0. -.Sp -Format specifiers: -.Sp -.Vb 3 -\& %n \- mode name -\& %d \- mode description -\& %D \- mode description without "Shows " prefix if any -.Ve -.Sp -These specifiers can receive an optional integer size, positive for right adjusted string or negative for left adjusted, example: \f(CW%8x\fR; and optional *num or *\-num, which means to leave only the first or last (if minus) num of chars, the num must be greater than 3, since the striped part is replaced with \*(L"...\*(R", example: %*30x. Both can be combined: %\-10*\-20x, this instructs to get only the 20 last characters, but if the length is less then 10 \- to fill with up to 10 spaces on the right. -.IP "\fB\-\-icon\-title\fR icon" 4 -.IX Item "--icon-title icon" -.PD 0 -.IP "\fB\-\-icon\-item\fR icon" 4 -.IX Item "--icon-item icon" -.PD -define menu icon for title and regular item accordingly. Default is no menu icons (equivalent to an empty icon argument). -.IP "\fB\-\-wm\-icons\fR" 4 -.IX Item "--wm-icons" -define icon names suitable for use with wm-icons package. Currently this is equivalent to: \-\-icon\-title '' \-\-icon\-item menu/lock.xpm. -.IP "\fB\-\-special\-first\fR" 4 -.IX Item "--special-first" -instructs to include special modes (usually black, bomb and random) first. -.PP -Option parameters can be specified either using '=' or in the next argument. Short options are ok if not ambiguous: \-h, \-t; but be careful with short options, what is now unambiguous, can became ambiguous in the next versions. -.PP -Additional arguments (after \fB\-\-\fR) will be passed to xlock. -.PP -Please see the \fBxlock\fR(1) man page for the xlock options. -.SH "USAGE" -.IX Header "USAGE" -Add these lines to your fvwm configuration file: -.PP -.Vb 6 -\& PipeRead \*(Aqfvwm\-menu\-xlock \-\-name MenuSSaver \-\-title "Screensaver" \e -\& \-\-icon\-item mini\-bball.xpm \-\-special\-first \-\- \-nice 19 \-nolock\*(Aq -\& PipeRead \*(Aqfvwm\-menu\-xlock \-\-name MenuSLock \-\-title "Lock Screen" \e -\& \-\-icon\-item mini\-rball.xpm \-\-special\-first \-\- \-nice 19\*(Aq -\& AddToMenu "Utilities" "Screensaver%mini\-monitor.xpm%" Popup MenuSSaver -\& AddToMenu "Utilities" "Screenlock%mini\-lock.xpm%" Popup MenuSLock -.Ve -.SH "AUTHORS" -.IX Header "AUTHORS" -Charles K. Hines , initial version. -.PP -Mikhael Goikhman , from 24 Feb 1999. -.SH "COPYING" -.IX Header "COPYING" -The script is distributed by the same terms as fvwm itself. See \s-1GNU\s0 General Public License for details. -.SH "BUGS" -.IX Header "BUGS" -Depends on the output of xlock. Will produce an empty menu if the structure of the output is changed. -.PP -Report bugs to fvwm\-bug@fvwm.org. diff --git a/bin/fvwm-menu-xlock.in b/bin/fvwm-menu-xlock.in index 4ff5231a6..2f423a1f0 100644 --- a/bin/fvwm-menu-xlock.in +++ b/bin/fvwm-menu-xlock.in @@ -141,7 +141,8 @@ sub wrong_usage { __END__ # --------------------------------------------------------------------------- - +# Manpage has been moved to doc/fvwm-menu-xlock.adoc. +# This is no longer used to generate the manpage. =head1 NAME fvwm-menu-xlock - builds xlock menu definition for fvwm diff --git a/bin/fvwm-perllib.1 b/bin/fvwm-perllib.1 deleted file mode 100644 index 4b5338c33..000000000 --- a/bin/fvwm-perllib.1 +++ /dev/null @@ -1,197 +0,0 @@ -.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.02) -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" Escape single quotes in literal strings from groff's Unicode transform. -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.ie \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.el \{\ -. de IX -.. -.\} -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "fvwm-perllib 1" -.TH fvwm-perllib 1 "2009-03-22" "2.5.28 (from cvs)" "Fvwm Utilities" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.if n .ad l -.nh -.SH "NAME" -fvwm\-perllib \- shows the documentation of the Fvwm Perl library -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -\&\fBfvwm-perllib\fR [ \fB\-\-help\fR|\fB\-h\fR|\fB\-?\fR ] [ \fB\-\-version\fR|\fB\-v\fR|\fB\-V\fR ] [ \fBman\fR [ \fIPerl::Class\fR ] ] [ \fBcat\fR [ \fIPerl::Class\fR ] ] [ \fBraw\fR [ \fIPerl::Class\fR ] ] [ \fBdir\fR ] -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -Starting from fvwm\-2.5.x versions there is a built-in support for creating fvwm modules in Perl. This \fBfvwm-perllib\fR utility provides help services for the Fvwm Perl library. -.SH "OPTIONS" -.IX Header "OPTIONS" -\&\fB\-\-help\fR show the help and exit -.PP -\&\fB\-\-version\fR show the version and exit -.PP -\&\fB\-\-man\fR or \fBman\fR [ \fIPerl::Class\fR ] show manual page just like \fIman\fR\|(1) -.PP -\&\fB\-\-cat\fR or \fBcat\fR [ \fIPerl::Class\fR ] show manual page in plain text -.PP -\&\fB\-\-raw\fR or \fBraw\fR [ \fIPerl::Class\fR ] generate output in man format (not human readable) -.PP -\&\fB\-\-dir\fR or \fBdir\fR print perllib directory without a trailing end of line -.SH "USAGE" -.IX Header "USAGE" -Use this in the fvwm modules written in Perl: -.PP -.Vb 1 -\& use lib \`fvwm\-perllib dir\`; -.Ve -.PP -Introduction to the Fvwm Perl library: -.PP -.Vb 1 -\& % fvwm\-perllib man -.Ve -.PP -Manual page for the \f(CW\*(C`FVWM::Module\*(C'\fR class: -.PP -.Vb 1 -\& % fvwm\-perllib man FVWM::Module -.Ve -.PP -Standard options: -.PP -.Vb 2 -\& % fvwm\-perllib \-\-help -\& % fvwm\-perllib \-\-version -.Ve -.SH "AUTHORS" -.IX Header "AUTHORS" -Mikhael Goikhman . -.SH "COPYING" -.IX Header "COPYING" -The script is distributed by the same terms as fvwm itself. See \s-1GNU\s0 General Public License for details. -.SH "BUGS" -.IX Header "BUGS" -No known bugs. -.PP -Report bugs to fvwm\-bug@fvwm.org. diff --git a/bin/fvwm-perllib.in b/bin/fvwm-perllib.in index 709c5860a..d872094f0 100644 --- a/bin/fvwm-perllib.in +++ b/bin/fvwm-perllib.in @@ -453,7 +453,8 @@ sub wrong_usage { __END__ # --------------------------------------------------------------------------- - +# Manpage has been moved to doc/fvwm-perllib.adoc. +# This is no longer used to generate the manpage. =head1 NAME fvwm-perllib - shows the documentation of the Fvwm Perl library diff --git a/configure.ac b/configure.ac index a9eab0ebf..084046ed5 100644 --- a/configure.ac +++ b/configure.ac @@ -111,7 +111,6 @@ if test x"$PERL" = x; then fi if test ! x"$PERL" = x; then AC_MSG_CHECKING([for perl $REQUIRED_PERL_VERSION or better]) - HAVE_PERL_FOR_DOCS=1 if ("$PERL" -e "require $REQUIRED_PERL_VERSION;") 2>/dev/null; then AC_MSG_RESULT(yes) else @@ -119,7 +118,6 @@ if test ! x"$PERL" = x; then AC_MSG_WARN([$PERL not found or too old]) fi else - HAVE_PERL_FOR_DOCS=0 AC_MSG_WARN([perl is not found, it is required for some scripts and modules]) AC_MSG_WARN([It is recommended to install perl $REQUIRED_PERL_VERSION or better later]) PERL=/usr/bin/perl @@ -309,12 +307,6 @@ if test ! x"$with_mandoc" = xno; then if test x"$ASCIIDOC" = x ; then with_mandoc="no" problem_mandoc=": No asciidoctor found in PATH" - elif test x"$SED" = x ; then - with_mandoc="no" - problem_mandoc=": No sed found in PATH" - elif test x"$HAVE_PERL_FOR_DOCS" = x0 ; then - with_mandoc="no" - problem_mandoc=": No perl found in PATH" else with_mandoc="yes" fi @@ -337,12 +329,6 @@ if test ! x"$with_htmldoc" = xno; then if test x"$ASCIIDOC" = x ; then with_htmldoc="no" problem_htmldoc=": No asciidoctor found in PATH" - elif test x"$SED" = x ; then - with_htmldoc="no" - problem_htmldoc=": No sed found in PATH" - elif test x"$HAVE_PERL_FOR_DOCS" = x0 ; then - with_htmldoc="no" - problem_htmldoc=": No perl found in PATH" else with_htmldoc="yes" fi diff --git a/doc/fvwm-menu-directory.adoc b/doc/fvwm-menu-directory.adoc new file mode 100644 index 000000000..fa51fb7c5 --- /dev/null +++ b/doc/fvwm-menu-directory.adoc @@ -0,0 +1,260 @@ += fvwm-menu-directory(1) + +== NAME + +fvwm-menu-directory - builds a directory browsing menu for fvwm + +== SYNOPSIS + +fvwm-menu-directory [ *--help*|*-h*|*-?* ] [ *--version*|*-V* ] +[ *--name*|*-na* NAME ] [ *--title*|*-t* NAME ] +[ *--item*|*-it* NAME ] [ *--icon-title*|*-icon-t* XPM ] +[ *--icon-dir*|*-icon-d* XPM ] [ *--icon-file*|*-icon-f* XPM ] +[ *--icon-app*|*-icon-a* XPM ] [ *--wm-icons* ] [ *--dir*|*-d* NAME ] +[ *--order*|*-o* NUM ] [ *--[no]all*|*-a* ] [ *--[no]links*|*-l* ] +[ *--xterm*|*-x* CMD ] [ *--exec-title*|*-exec-t* CMD ] +[ *--exec-file*|*-exec-f* CMD ] [ *--exec-app*|*-exec-a* [CMD] ] +[ *--command-title*|*-command-t* CMD ] [ *--command-file*|*-command-f* CMD ] +[ *--command-app*|*-command-a* CMD ] [ *--[no]reuse*|*-r* ] +[ *--[no]check-subdirs*|*-ch* ] [ *--special-dirs*|*-s* [VALUE] ] +[ *--[no]memory-for-speed*|*-mem* ] [ *--menu-style*|*-men* NAME ] +[ *--func-name*|*-f* NAME ] + +== DESCRIPTION + +A perl script which provides an output to read in with PipeRead to build +an fvwm menu containing a directory listing. Almost everything can be +configured. + +== HINTS + +The title item with its own attached action is usually added to the +menu. This may be used to define an action for the directory for which +the menu is built, such as starting a terminal in this directory (the +default). However, this may annoy some users. To disable the title +action use *--command-title ""*, to remove the title completely use +*--title ""*. + +== OPTIONS + +*--help*:: + Show the usage and exit. +*--version*:: + Show version and exit. +*--name* _name_:: + Menu name, used only with *--reuse*, default is `+MenuBrowser+`. +*--title* _title_:: + Menu title format, default is `+'%*-40p'+` - last 40 characters of the + current full path. TAB can be specified as `+'\t'+`, but in .fvwm2rc you + should specify a double backslash or a real TAB. ++ +Format specifiers: +`+%d+` - the current directory name `+%p+` - the current directory full path. ++ +These specifiers can receive an optional integer size, positive for +right adjusted string or negative for left adjusted, example: `+%8x+`; +and optional `+*num+` or `+*-num+`, which means to leave only the first +or last (if minus) num of chars, the num must be greater than 3, since the +striped part is replaced with ..., example: `+%*30x+`. Both can be combined: +`+%-10*-20x+`, this instructs to get only the 20 last characters, but if the +length is less then 10 - to fill with up to 10 spaces on the right. + +*--item* _format_:: + Menu item format, default is `+'%n'+`. TAB and width modifiers for `+%n+`, + `+%N+` and `+%s+` can be specified as described in *--title* above. + Note, specifying a non default format slows the script. ++ +Format specifiers: ++ +.... +%n - file/dir name (without the path) +%N - file/dir name (full with the path) +%d - file/dir date (yyyy-mm-dd HH:MM:SS) +%D - file/dir date (yyyy-mm-dd) +%s - file/dir size (in bytes) +%t - file/dir type (File|Dir |Link|Sock|Blck|Char|Pipe) +%T - file/dir type (F|D|L|S|B|C|P) +.... ++ +Example: `+--title '%*-40p\tDate, Type\tSize' --item '%*40n\t%d %t\t%s'+` + +*--icon-title* _icon_:: + Menu title icon, default is none. +*--icon-dir* _icon_:: + Menu dir icon, default is none. +*--icon-file* _icon_:: + Menu file icon, default is none. +*--icon-app* _icon_:: + Menu application icon, default is none. +*--wm-icons*:: + Define icon names suitable for use with wm-icons package. Currently this + is equivalent to: `+--icon-title menu/folder-open.xpm --icon-item + menu/file.xpm --icon-dir menu/folder.xpm --icon-app menu/utility.xpm+`. +*--dir* _dir_:: + Starting dir, default is `+${HOME-.}+`. +*--order* _number_:: + In the range (-6 .. 6), default is 5: ++ +.... +1 - do not sort +2 - dirs first +3 - files first +4 - sort by name +5 - dirs first +6 - files first +.... ++ +Negative number represents reverse order. + +*--[no]all*:: + Show hidden files, like in 'ls -A', default is *--noall*. +*--[no]links*:: + Follow linked directories, default is *--nolinks*. +*--xterm* _command_:: + X terminal call, default is 'xterm -e'. +*--exec-title* _command_:: + An fvwm Exec command on directory title (usually the shell), default is + `+${SHELL-/bin/sh}+`. '-' means no Exec command, i.e. Nop. If the command + is not started with '^' X terminal call is prepended. The command is + started in the currently browsed directory. +*--exec-file* _command_:: + An fvwm Exec command on regular files, default is `+${EDITOR-vi}+`. '-' + means no Exec command, i.e. Nop. If the command is not started with '^' + X terminal call is prepended. The actual file name is appended to the + command. +*--exec-app* [_command_]:: + An fvwm Exec command on +x files, default is '-', which means the same + command as on regular files. If no command is given, it is assumed to be + empty - simply run the +x file. If the command is not started with '^' X + terminal call is prepended. The actual file name is appended to the + command. +*--command-title* _command_:: + An fvwm command to execute on title. If this option is not given (or + command is '-'), the *--exec-title* is used instead. In the command, + `+%d+` is substituted with the full directory path. ++ +In fact, _--exec-title=tcsh_ is equivalent to _--command-title='Exec cd %d; xterm +-e tcsh'_. ++ +The empty value disables the title action. + +*--command-file* _command_:: + An fvwm command to execute on regular files. If this option is not given + (or command is '-'), the *--exec-file* is used instead. In the + command, `+%f+` is substituted with the full file path. ++ +In fact, _--exec-file=vi_ is equivalent to _--command-file='Exec xterm -e vi %f'_. + +*--command-app* _command_:: + An fvwm command to execute on +x files. If this option is not given (or + command is '-'), the *--command-app* is used instead. In the command, + `+%f+` is substituted with the full file path. ++ +In fact, _--exec-app=^exec_ is equivalent to _--command-app='Exec exec %f'_. + +*--[no]reuse*:: + No pop-up menus, reuse the same menu, default is *--noreuse*. When you + specify this option the Menu action is used, not Popup. Also, the *--name* + parameter is not ignored, and *--dir* parameter is ignored if there is + `+~/.fvwm/.fvwm-menu-directory.dir+` file. This file is only created or used + with this option specified, it is the only solution for the current fvwm + menu state. +*--[no]check-subdirs*:: + Check all subdirs for having execute (+x) permission and replace + "Popup"/"Menu" command with Nop for these without permissions. This has a + visual effect of disabling popup triangle in the subdirectory item. The + default is *--nocheck-subdirs*, because: 1) enabling this slows a bit the + script, 2) with this option enabled, if no icons used and no dir/file + separate sorting used there is no way to know that the item is directory + and not file. +*--special-dirs* _value_:: + Add .. or ~ or / special directories according to given optional value. + Without with option these directories are not added. Default value if + not specified is "1,2". The value is comma separated ordered special + directory indexes, where 1 is parent directory, 2 is home directory, 3 + is root directory. If minus is prepended to the value, special + directories are added at the bottom of menu instead of top. Value 0 or + any bad value is equivalent to non-specifying this option at all. +*--[no]memory-for-speed*:: + Use speed optimization, i.e. use previously created directory menus + without destroying it when closed, default is *--nomemory-for-speed*. ++ +Warning: speed optimization takes up a lot of memory that is never freed +again while fvwm is running. + +*--menu-style* _name_:: + Assign MenuStyle name to the menus. +*--func-name* _name_:: + Overwrite the default MissingSubmenuFunction name that is + FuncFvwmMenuDirectory. + +Option parameters can be specified either using '=' or in the next +argument. Short options are ok if not ambiguous: `+-a+`, `+-x+`, +`+-icon-f+`; but be careful with short options, what is now unambiguous, +can become ambiguous in the next versions. + +== USAGE + +Put this into your fvwm configuration file to invoke the script: + +.... +AddToFunc FuncFvwmMenuDirectory ++ I PipeRead "fvwm-menu-directory -d $0" +.... + +More complex example: + +.... +AddToFunc FuncFvwmMenuDirectory ++ I PipeRead "fvwm-menu-directory -d '$0' -x 'Eterm -g 80x40 -e' \\ + -a -l -o 6 --exec-app --exec-title 'tcsh -l' \\ + --exec-file 'vim -R' -t 'Go to: %d' --wm-icons" +.... + +And put this in the menu from which you want to pop-up the directory +menus: + +.... +AddToMenu SomeMenu MissingSubmenuFunction FuncFvwmMenuDirectory ++ "Home Directory" Popup $[HOME] ++ "Httpd Directory" Popup /home/httpd +.... + +Note: please use absolute path names. + +It is a good idea to set the menu pop-up delay to something positive and +enable busy cursor + +.... +MenuStyle * PopupDelayed, PopupDelay 200 +BusyCursor DynamicMenu True +.... + +in your configuration file when using this script for better results. + +Another interesting usage (`+'--reuse'+` or `+'-r'+` is mandatory for this): + +.... +AddToMenu Browser ++ DynamicPopupAction PipeRead \\ + "fvwm-menu-directory -r -na Browser -d / -s" +AddToMenu SomeMenu "My Browser" Menu Browser +.... + +Here the `+'--dir'+` parameter (starting directory) is ignored if there is +`+~/.fvwm/.fvwm-menu-directory.dir+` file, which you can delete. + +== AUTHORS + +Inspired on 1999-06-07 by Dominik Vogt . + +Rewritten on 1999-08-05 by Mikhael Goikhman . + +== COPYING + +The script is distributed by the same terms as fvwm itself. See GNU +General Public License for details. + +== BUGS + +Report bugs to or . diff --git a/doc/fvwm-menu-xlock.adoc b/doc/fvwm-menu-xlock.adoc new file mode 100644 index 000000000..1d33cab7a --- /dev/null +++ b/doc/fvwm-menu-xlock.adoc @@ -0,0 +1,102 @@ += fvwm-menu-xlock(1) + +== NAME + +fvwm-menu-xlock - builds xlock menu definition for fvwm + +== SYNOPSIS + +fvwm-menu-xlock [ **--help**|**-h**|**-?** ] [ **--version**|**-V** ] +[ **--name**|**-n** name ] [ **--title**|**-t** title ] +[ *--item* format ] [ *--icon-title* icon ] [ *--icon-item* icon ] +[ **--special-first**|**-s** ] [ *--* xlock params ] + +== DESCRIPTION + +A simple perl script which parses xlock's output to build an fvwm menu +definition of all xlock's modes. + +== OPTIONS + +*--help*:: + Show the help and exit. +*--version*:: + Show the version and exit. +*--name* _name_:: + Define menu name in the following argument. Default is XLockMenu. +*--title* _title_:: + Define menu title in the following argument. Default is XLock Modes. +*--item* _format_:: + Define menu item format in the following argument, default is + `+'%n\t(%d)'+`. TAB can be specified as `+'\t'+`, but in .fvwm2rc you should + specify a double backslash or a real TAB. ++ +Format specifiers: ++ +.... +%n - mode name +%d - mode description +%D - mode description without "Shows " prefix if any +.... ++ +These specifiers can receive an optional integer size, positive +for right adjusted string or negative for left adjusted, example: +`+%8x+`; and optional `+*num+` or `+*-num+`, which means to leave +only the first or last (if minus) num of chars, the num must be +greater than 3, since the striped part is replaced with ..., example: +`+%*30x+`. Both can be combined: `+%-10*-20x+`, this instructs to get +only the 20 last characters, but if the length is less then 10 - to +fill with up to 10 spaces on the right. + +*--icon-title* _icon_:: + Define menu icon for title. Default is no title icon + (equivalent to an empty icon argument). +*--icon-item* _icon_:: + Define menu icon for regular item. Default is no icon + (equivalent to an empty icon argument). +*--wm-icons*:: + Define icon names suitable for use with wm-icons package. Currently this + is equivalent to: *--icon-title '' --icon-item menu/lock.xpm*. +*--special-first*:: + Instructs to include special modes (usually black, bomb and random) + first. + +Option parameters can be specified either using '=' or in the next +argument. Short options are ok if not ambiguous: -h, -t; but be careful +with short options, what is now unambiguous, can became ambiguous in the +next versions. + +Additional arguments (after *--*) will be passed to xlock. + +Please see the *xlock*(1) man page for the xlock options. + +== USAGE + +Add these lines to your fvwm configuration file: + +.... +PipeRead 'fvwm-menu-xlock --name MenuSSaver --title "Screensaver" \ + --icon-item mini-bball.xpm --special-first -- -nice 19 -nolock' +PipeRead 'fvwm-menu-xlock --name MenuSLock --title "Lock Screen" \ + --icon-item mini-rball.xpm --special-first -- -nice 19' +AddToMenu "Utilities" "Screensaver%mini-monitor.xpm%" Popup MenuSSaver +AddToMenu "Utilities" "Screenlock%mini-lock.xpm%" Popup MenuSLock +.... + +== AUTHORS + +Charles K. Hines , initial version. + +Mikhael Goikhman , from 24 Feb 1999. + +== COPYING + +The script is distributed by the same terms as fvwm itself. See GNU +General Public License for details. + +== BUGS + +Depends on the output of xlock. Will produce an empty menu if the +structure of the output is changed. + +Report bugs to or . diff --git a/doc/fvwm-perllib.adoc b/doc/fvwm-perllib.adoc new file mode 100644 index 000000000..4f208de71 --- /dev/null +++ b/doc/fvwm-perllib.adoc @@ -0,0 +1,78 @@ += fvwm-perllib(1) + +== NAME + +fvwm-perllib - shows the documentation of the Fvwm Perl library + +== SYNOPSIS + +fvwm-perllib [ **--help**|**-h**|**-?** ] [ **--version**|**-v**|**-V** ] +[ *man* [ _Perl::Class_ ] ] [ *cat* [ _Perl::Class_ ] ] +[ *raw* [ _Perl::Class_ ] ] [ *dir* ] + +== DESCRIPTION + +Starting from fvwm-2.5.x versions there is a built-in support for +creating fvwm modules in Perl. This *fvwm-perllib* utility provides help +services for the Fvwm Perl library. + +== OPTIONS + +*--help*:: + Show the help and exit. + +*--version*:: + Show the version and exit. + +*--man* or *man* [ _Perl::Class_ ]:: + Show manual page just like *man*(1). + +*--cat* or *cat* [ _Perl::Class_ ]:: + Show manual page in plain text. + +*--raw* or *raw* [ _Perl::Class_ ]:: + Generate output in man format (not human readable). + +*--dir* or *dir*:: + Print perllib directory without a trailing end of line. + +== USAGE + +Use this in the fvwm modules written in Perl: + +.... +use lib `fvwm-perllib dir`; +.... + +Introduction to the Fvwm Perl library: + +.... +% fvwm-perllib man +.... + +Manual page for the `+FVWM::Module+` class: + +.... +% fvwm-perllib man FVWM::Module +.... + +Standard options: + +.... +% fvwm-perllib --help % fvwm-perllib --version +.... + +== AUTHORS + +Mikhael Goikhman . + +== COPYING + +The script is distributed by the same terms as fvwm itself. See GNU +General Public License for details. + +== BUGS + +No known bugs. + +Report bugs to or .