# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2017-02-09 23:29+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: =head1 #: wcd.pod:43 msgid "NAME" msgstr "" #. type: textblock #: wcd.pod:45 msgid "wcd - Wherever Change Directory" msgstr "" #. type: textblock #: wcd.pod:47 msgid "chdir for DOS and Unix" msgstr "" #. type: =head1 #: wcd.pod:49 msgid "SYNOPSIS" msgstr "" #. type: verbatim #: wcd.pod:51 #, no-wrap msgid "" " wcd [options] [directory]\n" "\n" msgstr "" #. type: =head1 #: wcd.pod:53 msgid "DESCRIPTION" msgstr "" #. type: =head2 #: wcd.pod:55 msgid "Overview" msgstr "" #. type: textblock #: wcd.pod:57 msgid "" "Wcd is a command-line program to change directory fast. It saves time typing " "at the keyboard. One needs to type only a part of a directory name and wcd " "will jump to it. Wcd has a fast selection method in case of multiple matches " "and allows aliasing and banning of directories. Wcd also includes a full " "screen interactive directory tree browser with speed search." msgstr "" #. type: textblock #: wcd.pod:63 msgid "" "Wcd was modeled after Norton Change Directory (NCD). NCD appeared first in " "I, for DOS in 1987, published by Peter " "Norton." msgstr "" #. type: textblock #: wcd.pod:66 msgid "" "Wcd has been ported to different command-line shells: DOS command.com, " "Windows cmd.exe and PowerShell, OS/2 cmd.exe, and Unix shells such as Bourne " "(sh), Bourne Again (bash), Korn (ksh), Z (zsh), and C (csh) shell and others " "running on any operating system." msgstr "" #. type: textblock #: wcd.pod:71 msgid "" "Wcd supports 8 bit character sets on all systems, and has optional support " "for Unicode. See section LOCALIZATION." msgstr "" #. type: textblock #: wcd.pod:74 msgid "See section INSTALLATION how to setup wcd for personal use." msgstr "" #. type: =head2 #: wcd.pod:76 msgid "Basic use" msgstr "" #. type: textblock #: wcd.pod:78 msgid "" "By default (if no wildcards are used) wcd searches for a directory with a " "name that begins with the typed name." msgstr "" #. type: textblock #: wcd.pod:81 msgid "" "For instance this command will change to directory to the current user's " "C:" msgstr "" #. type: verbatim #: wcd.pod:84 #, no-wrap msgid "" " wcd Desk\n" "\n" msgstr "" #. type: textblock #: wcd.pod:86 msgid "" "When there are multiple matches, wcd will present the user a list of all " "matches. The user can then make a selection with a few keystrokes (most of " "the times only one)." msgstr "" #. type: =head2 #: wcd.pod:90 msgid "Wildcards" msgstr "" #. type: textblock #: wcd.pod:92 msgid "Wcd supports following wildcards:" msgstr "" #. type: verbatim #: wcd.pod:94 #, no-wrap msgid "" " * matches any sequence of characters (zero or more)\n" " ? matches any character\n" " [SET] matches any character in the specified set,\n" " [!SET] or [^SET] matches any character not in the specified set.\n" "\n" msgstr "" #. type: textblock #: wcd.pod:99 msgid "" "A set is composed of characters or ranges; a range looks like I as in C<0-9> or C. The C<[0-9a-zA-Z_]> is the minimal " "set of characters allowed in the C<[..]> pattern construct. International " "characters (i.e. 8 bit characters) are allowed if the system supports " "them. To suppress the special syntactic significance of any of C<[]*?!^-\\> " "inside or outside a C<[..]> construct and match the character exactly, " "precede the character with a backslash (C<\\>) marker." msgstr "" #. type: textblock #: wcd.pod:108 msgid "" "Using wildcards makes powerful searching possible. For instance this matches " "any directory name that ends with \"top\":" msgstr "" #. type: verbatim #: wcd.pod:111 #, no-wrap msgid "" " wcd *top\n" "\n" msgstr "" #. type: textblock #: wcd.pod:113 msgid "Match directories that have \"top\" anywhere in the name:" msgstr "" #. type: verbatim #: wcd.pod:115 #, no-wrap msgid "" " wcd *top*\n" "\n" msgstr "" #. type: textblock #: wcd.pod:117 msgid "Match any directory name that begins with \"a\", \"b\" or \"c\":" msgstr "" #. type: verbatim #: wcd.pod:119 #, no-wrap msgid "" " wcd [a-c]*\n" "\n" msgstr "" #. type: textblock #: wcd.pod:121 msgid "" "It is also possible to give a part of a directory path. Here Wcd searches " "for directory that begins with \"Desk\" and which path matches I<*me/Desk*>." msgstr "" #. type: verbatim #: wcd.pod:124 #, no-wrap msgid "" " wcd me/Desk\n" "\n" msgstr "" #. type: textblock #: wcd.pod:126 msgid "" "It is allowed to type any kind of expression with slashes and wildcards. " "E.g.:" msgstr "" #. type: verbatim #: wcd.pod:129 #, no-wrap msgid "" " wcd src*/*1?/a*2\n" "\n" msgstr "" #. type: =head2 #: wcd.pod:131 msgid "Other uses" msgstr "" #. type: textblock #: wcd.pod:133 msgid "" "If no wildcards are used and wcd finds a perfect match, wcd will ignore all " "wild matches by default. This behaviour can be changed with the B<-w> " "option." msgstr "" #. type: textblock #: wcd.pod:136 msgid "The interactive directory tree browser can be started by using option B<-g>." msgstr "" #. type: verbatim #: wcd.pod:138 #, no-wrap msgid "" " wcd -g\n" "\n" msgstr "" #. type: textblock #: wcd.pod:140 msgid "" "Wcd generates a treedata file where it searches the directory. On Unix and " "Windows systems wcd does add symbolic links to the treedata file while " "scanning the disk, but does not follow them. While following links wcd could " "end up scanning infinite loops, or scan very large portions of a network." msgstr "" #. type: textblock #: wcd.pod:145 msgid "Wcd can also change to directories that are not in the treedata file. E.g.:" msgstr "" #. type: verbatim #: wcd.pod:147 #, no-wrap msgid "" " wcd ..\n" "\n" msgstr "" #. type: textblock #: wcd.pod:149 msgid "" "If wcd found a match but can't change to the directory it tries to remove it " "from the default treedata file. Not from the extra treedata file. See also " "option B<-k>." msgstr "" #. type: textblock #: wcd.pod:153 msgid "" "Wcd keeps a directory stack which is stored on disk. The stack has a default " "size of 10 and is cyclic. See options B<-z>, B<->, B<+> and B<=>." msgstr "" #. type: textblock #: wcd.pod:157 msgid "" "In multi-user environments option B<-u> can be used to change to directories " "of other users." msgstr "" #. type: textblock #: wcd.pod:161 msgid "" "On DOS and Windows systems it does not matter if you use a slash \"/\" or a " "backslash \"\\\" as a directory separator." msgstr "" #. type: textblock #: wcd.pod:164 msgid "" "It is possible on DOS and Windows systems to change drive and directory in " "one go by preceding the directory name with the drive name." msgstr "" #. type: verbatim #: wcd.pod:167 #, no-wrap msgid "" " wcd d:games\n" "\n" msgstr "" #. type: =head2 #: wcd.pod:171 msgid "Windows UNC paths" msgstr "" #. type: textblock #: wcd.pod:173 msgid "" "The Windows versions (Command Prompt, PowerShell, MSYS, zsh, cygwin) support " "Windows SMB LAN UNC paths without drive letter such as " "C<\\\\servername\\sharename>. Wcd for Windows Command Prompt makes use of " "the \"pushd\" command to automatically map a UNC path to a drive letter. In " "Windows PowerShell, MSYS, zsh and Cygwin UNC paths are fully supported. The " "current working directory can be a UNC path." msgstr "" #. type: =head2 #: wcd.pod:181 msgid "Interfaces" msgstr "" #. type: textblock #: wcd.pod:183 msgid "" "Wcd has three different interfaces to choose from a list of matches. The " "interface can be chosen at compile time." msgstr "" #. type: textblock #: wcd.pod:186 msgid "" "The first interface uses plain stdin/stdout. A numbered list is printed in " "the terminal. The user has to choose from the list by typing a number " "followed by . This interface does not provide scroll back " "functionality in case of a long list. The scroll back capability of the " "terminal/console has to be used. It is very small and portable." msgstr "" #. type: textblock #: wcd.pod:192 msgid "" "The second interface is built with the conio library. It provides a builtin " "scroll back capability. The user is presented a list numbered with letters. " "Choosing from a list can be done by pressing just one letter. This interface " "is fast because it saves keystrokes. If possible the screen will be restored " "after exiting. One who prefers to type numbers can use the B<-N> option." msgstr "" #. type: textblock #: wcd.pod:199 msgid "" "The third interface is built with the curses library. It is similar to the " "conio interface. The curses version of wcd has also an additional " "'graphical' interface. It lets the user select a directory via a full screen " "interactive directory tree browser. It has a vim(1) like navigation and " "search method. It can be activated with option B<-g>." msgstr "" #. type: textblock #: wcd.pod:205 msgid "" "By using the B<-o> option one can always fall back to the stdin/stdout " "interface." msgstr "" #. type: =head1 #: wcd.pod:208 msgid "OPTIONS" msgstr "" #. type: =item #: wcd.pod:212 msgid "B<-a>" msgstr "" #. type: textblock #: wcd.pod:214 msgid "Add current path to the default treedata file." msgstr "" #. type: textblock #: wcd.pod:216 msgid "" "Use this option to quickly add the current path to the default treedata " "file. Re-scanning the complete disk can take a long time in some cases." msgstr "" #. type: =item #: wcd.pod:219 msgid "B<-aa>" msgstr "" #. type: textblock #: wcd.pod:221 msgid "Add current and all parent paths to the default treedata file." msgstr "" #. type: =item #: wcd.pod:223 msgid "B<-A PATH>" msgstr "" #. type: textblock #: wcd.pod:225 msgid "" "Scan directory tree from I and append to the default treedata " "file. Examples:" msgstr "" #. type: verbatim #: wcd.pod:228 #, no-wrap msgid "" " wcd -A .\n" " wcd -A /home -A /etc\n" " wcd -A d: -A e: -A \\\\server\\share\n" "\n" msgstr "" #. type: textblock #: wcd.pod:232 msgid "" "On Windows one can scan all shared directories of a Windows LAN server by " "typing something like: C." msgstr "" #. type: textblock #: wcd.pod:236 msgid "See also option B<-S> and B<-s> and B<-E>." msgstr "" #. type: =item #: wcd.pod:238 msgid "B<-b>" msgstr "" #. type: textblock #: wcd.pod:240 msgid "Ban current path." msgstr "" #. type: textblock #: wcd.pod:242 msgid "" "Wcd places the current path in the ban file. This means that wcd ignores all " "matches of this directory and its sub directories." msgstr "" #. type: textblock #: wcd.pod:245 msgid "" "The ban file can be edited with a text editor. Use of wildcards is supported " "and names are matched against the absolute path." msgstr "" #. type: textblock #: wcd.pod:248 msgid "" "Banned paths are not excluded from scanning the disk. To do that use option " "B<-xf>." msgstr "" #. type: =item #: wcd.pod:251 msgid "B<-c, --direct-cd>" msgstr "" #. type: textblock #: wcd.pod:253 msgid "Direct CD mode. By default wcd works as follows:" msgstr "" #. type: verbatim #: wcd.pod:255 #, no-wrap msgid "" " 1. Try to find a match in the treedata file(s)\n" " 2. If no match, try to open the directory you typed.\n" "\n" msgstr "" #. type: textblock #: wcd.pod:258 msgid "In direct CD mode wcd works in reversed order." msgstr "" #. type: verbatim #: wcd.pod:260 #, no-wrap msgid "" " 1. Try to open the directory you typed.\n" " 2. If not, try to find a match in the treedata file(s).\n" "\n" msgstr "" #. type: =item #: wcd.pod:264 msgid "B<-d DRIVE>" msgstr "" #. type: textblock #: wcd.pod:266 msgid "Set drive for stack and go file (DOS only)." msgstr "" #. type: textblock #: wcd.pod:268 msgid "" "The stack file and the go-script are by default stored on drive C: if " "environment variable I is not set. Use this option if drive C: is a " "read-only drive. This option must be used in front of the stack options " "B<->, B<+> and B<=>." msgstr "" #. type: =item #: wcd.pod:273 msgid "B<-e>" msgstr "" #. type: textblock #: wcd.pod:275 msgid "Add current path to the extra treedata file." msgstr "" #. type: textblock #: wcd.pod:277 msgid "Use this option to quickly add the current path to the extra treedata file." msgstr "" #. type: =item #: wcd.pod:279 msgid "B<-ee>" msgstr "" #. type: textblock #: wcd.pod:281 msgid "Add current and all parent paths to extra treedata file." msgstr "" #. type: =item #: wcd.pod:283 msgid "B<-E PATH>" msgstr "" #. type: textblock #: wcd.pod:285 msgid "" "Scan directory tree from I and append to Extra treedata file. See also " "options B<-A> and B<-S>." msgstr "" #. type: =item #: wcd.pod:288 msgid "B<-f FILE>" msgstr "" #. type: textblock #: wcd.pod:290 msgid "Read treedata file I. Do not read the default treedata file." msgstr "" #. type: =item #: wcd.pod:292 msgid "B<+f FILE>" msgstr "" #. type: textblock #: wcd.pod:294 msgid "Read treedata file I in addition to the default treedata file." msgstr "" #. type: =item #: wcd.pod:296 msgid "B<-g>" msgstr "" #. type: textblock #: wcd.pod:298 msgid "Graphical interface (only in version with curses interface)." msgstr "" #. type: textblock #: wcd.pod:300 msgid "" "Wcd starts a textual curses based 'graphical' interface. The user can select " "a directory via a full-screen interactive directory tree browser. It has a " "vim(1) like navigation and search method." msgstr "" #. type: textblock #: wcd.pod:304 msgid "" "If no search string is given wcd presents the whole tree which is in the " "default treedata file and the extra treedata files." msgstr "" #. type: textblock #: wcd.pod:307 msgid "If a search string is given the match list is presented as a directory tree." msgstr "" #. type: textblock #: wcd.pod:310 msgid "" "The default tree layout is similar to the tree layout of the original NCD on " "DOS. The difference in layout is that in NCD all directories of a same depth " "level were vertically aligned over the whole tree. This was possible in NCD, " "because the maximum width of a directory name in DOS was 12 (8.3) " "characters. On modern operating systems directory names can be very long, so " "also the differences in length can be large. Therefore folders with a same " "depth are not vertically aligned over the whole tree in wcd, but only in " "sub-branches. So there is some sideways movement when moving straight up " "and down from one sub-branch to another sub-branch." msgstr "" #. type: textblock #: wcd.pod:320 msgid "" "The navigation behaviour in Wcd is exactly the same as in the original " "NCD. For instance if you push the Down key you go down to the next directory " "with the same depth level, jumping over branches. This enables fast " "navigation through the tree." msgstr "" #. type: textblock #: wcd.pod:325 msgid "See options B<-Ta>, B<-TC>, and B<-Tc> to change the navigation behaviour." msgstr "" #. type: =item #: wcd.pod:327 msgid "B<-gd>" msgstr "" #. type: textblock #: wcd.pod:329 msgid "Dump the treedata files as a tree to stdout." msgstr "" #. type: =item #: wcd.pod:331 msgid "B<-G PATH>" msgstr "" #. type: textblock #: wcd.pod:333 msgid "" "Write go-script in directory I. For instance on Unix, C " "will write a go-script B." msgstr "" #. type: =item #: wcd.pod:336 msgid "B<-GN, --no-go-script>" msgstr "" #. type: textblock #: wcd.pod:338 msgid "" "Do not create go-script. This option can be used in combination with the " "option B<-j> if one does not want wcd to create a go-script." msgstr "" #. type: =item #: wcd.pod:341 msgid "B<-h, --help>" msgstr "" #. type: textblock #: wcd.pod:343 msgid "Show help and exit." msgstr "" #. type: =item #: wcd.pod:345 msgid "B<-i, --ignore-case>" msgstr "" #. type: textblock #: wcd.pod:347 msgid "" "Ignore case. Dos and Windows versions of wcd ignore case " "default. Unix/Cygwin versions regard case by default." msgstr "" #. type: =item #: wcd.pod:351 msgid "B<+i, --no-ignore-case>" msgstr "" #. type: textblock #: wcd.pod:353 msgid "Regard case. See also option B<-i>." msgstr "" #. type: =item #: wcd.pod:355 msgid "B<-I, --ignore-diacritics>" msgstr "" #. type: textblock #: wcd.pod:357 msgid "" "Ignore diacritics for Latin-based scripts. Letters with diacritical marks " "match their base letter without diacritical mark. The following Latin " "encodings are supported: CP437, CP850, CP852, CP1250, CP1252, ISO-8859-1, " "ISO-8859-2, and Unicode Latin-1, Latin Extended-A, and Latin Extended-B. " "See also L" msgstr "" #. type: =item #: wcd.pod:364 msgid "B<+I, --no-ignore-diacritics>" msgstr "" #. type: textblock #: wcd.pod:366 msgid "Regard diacritics (default). See also option B<-I>." msgstr "" #. type: =item #: wcd.pod:368 msgid "B<-j, --just-go>" msgstr "" #. type: textblock #: wcd.pod:370 msgid "Just go mode." msgstr "" #. type: textblock #: wcd.pod:372 msgid "" "In this mode wcd will not present a list when there is more than one " "directory that matches the given directory. Wcd will just change to the " "first option. When wcd is invoked again with the same arguments it will " "change to the next option, and so on." msgstr "" #. type: textblock #: wcd.pod:377 msgid "" "Wcd will print the directory to go to to stdout. So a different installation " "method can be used. One could make the following function for a POSIX " "compatible shell:" msgstr "" #. type: verbatim #: wcd.pod:381 #, no-wrap msgid "" " wcd ()\n" " {\n" " cd \"$($HOME/bin/wcd.exe -j $@)\"\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:386 msgid "" "When you are using an old shell that doesn't support \"$()\" command " "substitution you have to use old style command substitution with " "back-quotes." msgstr "" #. type: verbatim #: wcd.pod:389 #, no-wrap msgid "" " wcd ()\n" " {\n" " cd \"`$HOME/bin/wcd.exe -j $@`\"\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:395 msgid "" "On Windows systems, if one is running 4NT shell, one could make the " "following alias:" msgstr "" #. type: verbatim #: wcd.pod:398 #, no-wrap msgid "" " alias wcd `cd %@execstr[wcdwin32.exe -z 0 -j %1]`\n" "\n" msgstr "" #. type: textblock #: wcd.pod:401 msgid "" "This method eliminates the need of the go-script, so one can use option " "B<-GN> in combination with B<-j>." msgstr "" #. type: =item #: wcd.pod:404 msgid "B<-k, --keep-paths>" msgstr "" #. type: textblock #: wcd.pod:406 msgid "Keep paths." msgstr "" #. type: textblock #: wcd.pod:408 msgid "" "Keep paths in the treedata file when wcd can't change to them. The default " "behaviour of wcd is that it tries to remove paths from the treedata when wcd " "can't change to them. With this option this behavior is turned off." msgstr "" #. type: =item #: wcd.pod:412 msgid "B<-K, --color>" msgstr "" #. type: textblock #: wcd.pod:414 msgid "Use colors in graphical mode." msgstr "" #. type: =item #: wcd.pod:416 msgid "B<-l ALIAS>" msgstr "" #. type: textblock #: wcd.pod:418 msgid "" "Name the current path with I. Wcd places the current path with alias " "I in the alias file. Aliases are case sensitive." msgstr "" #. type: =item #: wcd.pod:421 msgid "B<-ls>" msgstr "" #. type: textblock #: wcd.pod:423 msgid "Show the name of the alias file, and list all the aliases." msgstr "" #. type: =item #: wcd.pod:425 msgid "B<-m DIR>" msgstr "" #. type: textblock #: wcd.pod:427 msgid "Make directory and add to treedata file." msgstr "" #. type: =item #: wcd.pod:429 msgid "B<-L, --license>" msgstr "" #. type: textblock #: wcd.pod:431 msgid "Print the distribution license." msgstr "" #. type: =item #: wcd.pod:433 msgid "B<-M DIR>" msgstr "" #. type: textblock #: wcd.pod:435 msgid "Make directory and add to extra treedata file." msgstr "" #. type: =item #: wcd.pod:437 msgid "B<-n PATH>" msgstr "" #. type: textblock #: wcd.pod:439 msgid "Read relative treedata file from I." msgstr "" #. type: textblock #: wcd.pod:441 msgid "" "Do not read the default treedata file. The relative treedata file should " "already have been created using the wcd B<+S> option. I may also " "point to a file directly." msgstr "" #. type: textblock #: wcd.pod:445 msgid "" "An example. Suppose another system has been mounted to mount point " "C:" msgstr "" #. type: verbatim #: wcd.pod:448 #, no-wrap msgid "" " wcd -n /mnt/network src\n" "\n" msgstr "" #. type: textblock #: wcd.pod:450 msgid "" "Wcd opens the relative treedata file in C. The file contains " "the paths relative from that point." msgstr "" #. type: =item #: wcd.pod:453 msgid "B<+n PATH>" msgstr "" #. type: textblock #: wcd.pod:455 msgid "" "Read relative treedata file in addition to the default treedata file. See " "option B<-n>." msgstr "" #. type: =item #: wcd.pod:458 msgid "B<-N, --numbers>" msgstr "" #. type: textblock #: wcd.pod:460 msgid "Use numbers instead of letters." msgstr "" #. type: textblock #: wcd.pod:462 msgid "" "Wcd with a conio or curses based interface (see section Interfaces) presents " "a match list by default numbered with letters. When the B<-N> option is used " "the match list is numbered with numbers. Regardless of the B<-N> option one " "can type a letter or numbers to make a selection from the list of matches." msgstr "" #. type: =item #: wcd.pod:467 msgid "B<-o>" msgstr "" #. type: textblock #: wcd.pod:469 msgid "Use stdin/stdout interface." msgstr "" #. type: textblock #: wcd.pod:471 msgid "" "When for some kind of reason the conio or curses interface of wcd does not " "work one can fall back to the stdin/stdout interface of wcd by using the " "B<-o> option." msgstr "" #. type: =item #: wcd.pod:475 msgid "B<-od, --to-stdout>" msgstr "" #. type: textblock #: wcd.pod:477 msgid "Dump all matches to stdout." msgstr "" #. type: =item #: wcd.pod:479 msgid "B<-q, --quiet>" msgstr "" #. type: textblock #: wcd.pod:481 msgid "Quieter operation. Printing of the final match is suppressed." msgstr "" #. type: =item #: wcd.pod:483 msgid "B<-r DIR>" msgstr "" #. type: textblock #: wcd.pod:485 msgid "Remove directory and remove from the treedata file." msgstr "" #. type: textblock #: wcd.pod:487 msgid "" "If the directory is empty, wcd will remove it, and try to remove it from the " "treedata file." msgstr "" #. type: =item #: wcd.pod:490 msgid "B<-rmtree DIR>" msgstr "" #. type: textblock #: wcd.pod:492 msgid "Recursively remove directory and remove from the treedata file." msgstr "" #. type: textblock #: wcd.pod:494 msgid "" "Wcd will remove the directory and all its sub directories and files, and " "remove the directories from the treedata file." msgstr "" #. type: =item #: wcd.pod:497 msgid "B<-s>" msgstr "" #. type: textblock #: wcd.pod:499 msgid "" "(re)Scan disk from C<$HOME> directory. If I is not defined the disk is " "scanned from root directory /." msgstr "" #. type: textblock #: wcd.pod:502 msgid "The existing default treedata file is overwritten." msgstr "" #. type: textblock #: wcd.pod:504 msgid "" "The default scan directory can be overruled with environment variable " "C. See section ENVIRONMENT VARIABLES." msgstr "" #. type: =item #: wcd.pod:507 msgid "B<-S PATH>" msgstr "" #. type: textblock #: wcd.pod:509 msgid "" "Scan directory tree from I and overwrite the default treedata file. " "See also options B<-A>, B<-s> and B<-E>. E.g. with option B<-A> you can " "create a default treedata file of your choice. Examples:" msgstr "" #. type: textblock #: wcd.pod:513 msgid "Unix:" msgstr "" #. type: verbatim #: wcd.pod:515 #, no-wrap msgid "" " wcd -S /\n" " wcd -S /home -A /etc -A /usr\n" "\n" msgstr "" #. type: textblock #: wcd.pod:518 msgid "DOS/Windows:" msgstr "" #. type: verbatim #: wcd.pod:520 #, no-wrap msgid "" " wcd -S c:/\n" " wcd -S c: -A d: -A \\\\server\\share\n" "\n" msgstr "" #. type: textblock #: wcd.pod:523 msgid "" "With the Windows versions one can scan all shared directories of a Windows " "LAN server by typing something like: C." msgstr "" #. type: =item #: wcd.pod:527 msgid "B<+S PATH>" msgstr "" #. type: textblock #: wcd.pod:529 msgid "" "Scan disk from I and place relative paths in a relative treedata " "file. This file is used by the B<-n> and B<+n> options of wcd. E.g. C." msgstr "" #. type: =item #: wcd.pod:533 msgid "B<-t>" msgstr "" #. type: textblock #: wcd.pod:535 msgid "Do not strip tmp mount dir C (Unix only)" msgstr "" #. type: textblock #: wcd.pod:537 msgid "" "Wcd strips by default C from the match. Directory C is " "used by the auto-mounter. This behaviour can be turned off with the B<-t> " "option." msgstr "" #. type: =item #: wcd.pod:541 msgid "B<-T, --ascii-tree>" msgstr "" #. type: textblock #: wcd.pod:543 msgid "" "Draw tree with ASCII characters. Use this option if line drawing characters " "are not displayed properly in your terminal." msgstr "" #. type: =item #: wcd.pod:546 msgid "B<-Ta, --alt-tree-nav>" msgstr "" #. type: textblock #: wcd.pod:548 msgid "Alternative way of navigation in the graphical tree." msgstr "" #. type: textblock #: wcd.pod:550 msgid "" "In the default NCD style tree layout the B<-Ta> option disables jumping to " "unrelated directories." msgstr "" #. type: textblock #: wcd.pod:553 msgid "" "In compact tree mode the alternative mode makes navigation similar to " "navigation in GUI file managers such as Windows Explorer or Linux KDE " "Konqueror. Pressing Up and Down moves the selected folder one line up or " "down. Pressing Left first folds the sub-folders and the next move left moves " "really left." msgstr "" #. type: textblock #: wcd.pod:559 msgid "" "You can switch on-the-fly between default and alternative navigation by " "pressing ." msgstr "" #. type: textblock #: wcd.pod:562 msgid "" "When alternative navigation mode is on, you will see an \"A\" in the lower " "right corner." msgstr "" #. type: =item #: wcd.pod:564 msgid "B<-TC, --center-tree>" msgstr "" #. type: textblock #: wcd.pod:566 msgid "" "Centered view in the graphical tree. The selected directory stays in the " "middle of the screen. The centered mode can also be switched on and off with " "key in the graphical tree." msgstr "" #. type: textblock #: wcd.pod:570 msgid "" "The standard non-centered behaviour, which minimises tree movement, is the " "same as in the original NCD." msgstr "" #. type: =item #: wcd.pod:573 msgid "B<-Tc, --compact-tree>" msgstr "" #. type: textblock #: wcd.pod:575 msgid "" "By default the 'graphical' tree is drawn the same way as the original NCD on " "DOS did it. On DOS a directory path could only be 66 characters in " "total. With the deep directory structures of today the tree can become very " "wide. To overcome this wcd can draw the tree in a compact way, similar to " "most GUI file managers, with only one folder per line. Use option B<-Tc> or " "switch on-the-fly with the key." msgstr "" #. type: =item #: wcd.pod:582 msgid "B<-Td, --cjk-width>" msgstr "" #. type: textblock #: wcd.pod:584 msgid "" "Legacy East-Asian CJK (Chinese, Japanese, and Korean) fonts have certain " "characters and line drawing symbols with a column width of 2, while the " "normal Unicode width for these characters is 1 column. For instance the " "Chinese CP936 raster font on Windows and the Simsun font. Use this option " "for a correct outlining of the graphical tree when a legacy CJK font is " "used." msgstr "" #. type: textblock #: wcd.pod:590 msgid "When CJK mode is on, you will see a \"C\" in the lower right corner." msgstr "" #. type: =item #: wcd.pod:592 msgid "B<-u USER>" msgstr "" #. type: textblock #: wcd.pod:594 msgid "" "Scan treedata file of another user based on I, do not scan your own " "default treedata file. See also section ENVIRONMENT VARIABLES for " "I." msgstr "" #. type: textblock #: wcd.pod:597 msgid "" "On Unix/Cygwin the base directory for user home directories is assumed to be " "C. Wcd will look for C and " "C, in that order, and read the first one that " "exists and is readable. On DOS/Windows the base directory for user home " "directories is assumed to be C<\\\\users>, so wcd tries to read " "C<\\\\users\\USER\\treedata.wcd> and C<\\\\users\\USER\\.wcd\\treedata.wcd>." msgstr "" #. type: =item #: wcd.pod:605 msgid "B<+u USER>" msgstr "" #. type: textblock #: wcd.pod:607 msgid "Read default treedata file of USER in addition to your own treedata file." msgstr "" #. type: =item #: wcd.pod:610 msgid "B<-v, --verbose>" msgstr "" #. type: textblock #: wcd.pod:612 msgid "" "Display verbose messages. With this option wcd prints all filters, bans and " "excludes." msgstr "" #. type: =item #: wcd.pod:615 msgid "B<-V, --version>" msgstr "" #. type: textblock #: wcd.pod:617 msgid "Print version information and exit." msgstr "" #. type: =item #: wcd.pod:619 msgid "B<-w, --wild-match-only>" msgstr "" #. type: textblock #: wcd.pod:621 msgid "Wild matching only. Treat all matches as wild matches." msgstr "" #. type: =item #: wcd.pod:623 msgid "B<-x PATH>" msgstr "" #. type: textblock #: wcd.pod:625 msgid "Exclude I from scanning." msgstr "" #. type: textblock #: wcd.pod:627 msgid "" "When this option is used wcd will exclude I and all its subdirectories " "when wcd is scanning a disk. Wildcards are supported and matched against " "absolute paths. Option B<-x> can be used multiple times." msgstr "" #. type: verbatim #: wcd.pod:631 #, no-wrap msgid "" " wcd -x -x -s\n" "\n" msgstr "" #. type: textblock #: wcd.pod:633 msgid "" "Option B<-x> must be used in front of any scan option (B<-s>, B<-S>, B<+S>, " "B<-A>, B<-E>)." msgstr "" #. type: textblock #: wcd.pod:637 msgid "" "On DOS/Windows systems one must specify the drive letter depending on if " "environment variable I or I is set. If I or I " "is set one needs to specify the drive letter. An example:" msgstr "" #. type: verbatim #: wcd.pod:641 #, no-wrap msgid "" " wcd -x c:/temp -S c:\n" "\n" msgstr "" #. type: textblock #: wcd.pod:643 msgid "Otherwise do not specify drive letter." msgstr "" #. type: verbatim #: wcd.pod:645 #, no-wrap msgid "" " wcd -x /temp -s\n" "\n" msgstr "" #. type: =item #: wcd.pod:648 msgid "B<-xf FILE>" msgstr "" #. type: textblock #: wcd.pod:650 msgid "Exclude all paths listed in I from scanning." msgstr "" #. type: textblock #: wcd.pod:652 msgid "" "When this option is used wcd will exclude all paths listed in I and " "all their subdirectories when wcd is scanning a disk. Wildcards are " "supported and they are matched against absolute paths; one path per line. Be " "aware that wcd will not ignore leading or trailing blanks on a line, because " "they are legal characters in a directory name. Option B<-xf> can be used " "multiple times. When one wants to exclude all banned paths from scanning one " "can do the following (example for wcd on unix):" msgstr "" #. type: verbatim #: wcd.pod:660 #, no-wrap msgid "" " wcd -xf ~/.ban.wcd -s\n" "\n" msgstr "" #. type: textblock #: wcd.pod:662 msgid "" "Wildcards are supported. For instance to exclude all your Subversion " "directories with administrative files add a line with C<*/.svn>." msgstr "" #. type: textblock #: wcd.pod:665 msgid "" "Option B<-xf> must be used in front of any scan option (B<-s>, B<-S>, B<+S>, " "B<-A>, B<-E>)." msgstr "" #. type: =item #: wcd.pod:668 msgid "B<-y, --assume-yes>" msgstr "" #. type: textblock #: wcd.pod:670 msgid "Assume Yes on all queries." msgstr "" #. type: textblock #: wcd.pod:672 msgid "" "Wcd will not prompt the user with yes/no questions, but assumes the user " "answers yes on all questions. This can be used in combination with option " "B<-rmtree>. This option must be used in front of options that can lead to " "yes/no questions." msgstr "" #. type: =item #: wcd.pod:677 msgid "B<-z NUMBER>" msgstr "" #. type: textblock #: wcd.pod:679 msgid "Set maximum stack size to NUMBER." msgstr "" #. type: textblock #: wcd.pod:681 msgid "" "The default size of the stack is 10. Stack operation can be turned off by " "setting the size to 0. This option must be used in front of any other stack " "operations (B<->,B<+>,B<=>). Otherwise the size of the stack will be set " "back to the default 10." msgstr "" #. type: textblock #: wcd.pod:686 msgid "A correct command is:" msgstr "" #. type: verbatim #: wcd.pod:688 #, no-wrap msgid "" " wcd -z 50 -\n" "\n" msgstr "" #. type: textblock #: wcd.pod:690 msgid "" "The new stack size will be 50, wcd will go one directory back. A wrong " "command is:" msgstr "" #. type: verbatim #: wcd.pod:693 #, no-wrap msgid "" " wcd - -z 50\n" "\n" msgstr "" #. type: textblock #: wcd.pod:695 msgid "" "Wcd goes one directory back, the stack gets the default size 10. The B<-z " "50> is ignored." msgstr "" #. type: textblock #: wcd.pod:698 msgid "" "Add this option as the first option to your wcd alias or function. E.g. for " "the a POSIX compatible shell this would be:" msgstr "" #. type: verbatim #: wcd.pod:701 #, no-wrap msgid "" " wcd ()\n" " {\n" "\twcd.exe -z 50 \"$@\"\n" "\t. ${WCDHOME:-${HOME}}/bin/wcd.go\n" " }\n" "\n" msgstr "" #. type: =item #: wcd.pod:707 msgid "B<-[NUMBER]>" msgstr "" #. type: textblock #: wcd.pod:709 msgid "Push dir NUMBER of times. Default is one." msgstr "" #. type: textblock #: wcd.pod:711 msgid "" "Go back a directory. Command C goes one directory back. To go more " "directories back add a number to it. E.g. command C. The stack is " "cyclic." msgstr "" #. type: =item #: wcd.pod:715 msgid "B<+[NUMBER]>" msgstr "" #. type: textblock #: wcd.pod:717 msgid "Pop dir NUMBER of times. Default is one." msgstr "" #. type: textblock #: wcd.pod:719 msgid "" "Go forward a directory. Command C goes one directory forward. To go " "more directories forward add a number to it. E.g. command C. The " "stack is cyclic." msgstr "" #. type: =item #: wcd.pod:723 msgid "B<=>" msgstr "" #. type: textblock #: wcd.pod:725 msgid "Show stack." msgstr "" #. type: textblock #: wcd.pod:727 msgid "" "Use this option if you do not know anymore how many times to push or pop. " "The stack is printed and you can choose a number. The current place in the " "stack is marked with an asterisk C<*>." msgstr "" #. type: =head1 #: wcd.pod:733 msgid "INSTALLATION" msgstr "" #. type: textblock #: wcd.pod:735 msgid "" "The current working directory of a Unix shell can only be changed by the " "builtin cd(1) command. Therefore the program is always called by a function " "or an alias. The function or alias sources a shell script (go-script) which " "is generated by the wcd program. Wcd can only work after the function or " "alias is defined." msgstr "" #. type: textblock #: wcd.pod:741 msgid "" "Another important influence on your installation is the definition of " "environment variables I and I. See section ENVIRONMENT " "VARIABLES." msgstr "" #. type: =head2 #: wcd.pod:745 msgid "Install for POSIX type shells" msgstr "" #. type: textblock #: wcd.pod:747 msgid "" "For a POSIX shell (ksh, bash, zsh, etc.) on Unix, Linux, Cygwin, or native " "MSYS add the following function to the shell startup file (e.g. Bash uses " "C<$HOME/.bashrc>):" msgstr "" #. type: verbatim #: wcd.pod:751 #, no-wrap msgid "" " wcd ()\n" " {\n" " /wcd.exe \"$@\"\n" " . ${WCDHOME:-${HOME}}/bin/wcd.go\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:757 msgid "" "Replace I with the location where the wcd executable has been " "installed. Reload the shell initialization files or start new shell." msgstr "" #. type: textblock #: wcd.pod:760 msgid "The location of the go-script C differs per shell." msgstr "" #. type: textblock #: wcd.pod:762 msgid "" "Wcd for DJGPP DOS bash and OS/2 bash require a different function. The go " "script is not written in a directory C, and if I and I " "are both not defined the go-script is written on c:/." msgstr "" #. type: textblock #: wcd.pod:766 msgid "DOS bash:" msgstr "" #. type: verbatim #: wcd.pod:768 #, no-wrap msgid "" " wcd ()\n" " {\n" " /wcdbash.exe \"$@\"\n" " . ${WCDHOME:-${HOME:-\"c:\"}}/wcd.go\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:774 msgid "OS/2 bash:" msgstr "" #. type: verbatim #: wcd.pod:776 #, no-wrap msgid "" " wcd ()\n" " {\n" " /wcdos2bash.exe \"$@\"\n" " . ${WCDHOME:-${HOME:-\"c:\"}}/wcd.go\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:782 msgid "" "The WinZsh version of wcd requires a bit different function. The go-script " "will never be written in c:/." msgstr "" #. type: verbatim #: wcd.pod:785 #, no-wrap msgid "" " wcd ()\n" " {\n" " /wcdwin32zsh.exe \"$@\"\n" " . ${WCDHOME:-${HOME}}/wcd.go\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:791 msgid "See section FILES for more information." msgstr "" #. type: =head2 #: wcd.pod:793 msgid "Install for C-alike shells (csh, tcsh)" msgstr "" #. type: textblock #: wcd.pod:795 msgid "" "Add the following alias to the shell startup file C<$HOME/.cshrc> or " "C<$HOME/.tcshrc> :" msgstr "" #. type: verbatim #: wcd.pod:798 #, no-wrap msgid "" " if ( ${?WCDHOME} ) then\n" " alias wcd \"/wcd.exe \\!* ; source $WCDHOME/bin/wcd.go\"\n" " else\n" " alias wcd \"/wcd.exe \\!* ; source $HOME/bin/wcd.go\"\n" " endif\n" "\n" msgstr "" #. type: textblock #: wcd.pod:804 msgid "" "Replace I with the location where the wcd executable has been " "installed. Reload the shell initialization files or start a new shell." msgstr "" #. type: =head2 #: wcd.pod:808 msgid "Windows Command Prompt version" msgstr "" #. type: textblock #: wcd.pod:810 msgid "" "Unpack the zip file and add directory C to your environment variable " "I." msgstr "" #. type: textblock #: wcd.pod:813 msgid "" "In Windows Command Prompt a Windows program cannot change the current work " "directory, but a .bat file can. The batch scrip C runs the wcd " "program which generates a new batch script C. Then C " "runs C which actually changes the directory." msgstr "" #. type: =head2 #: wcd.pod:818 msgid "Windows VISTA and higher" msgstr "" #. type: textblock #: wcd.pod:820 msgid "" "In a Windows VISTA and higher Command Prompt you may have limited access to " "directories. To get access to more directories you need administrator " "rights. You can get a Command Prompt with administrator rights if you right " "click on the Command Prompt icon and select I." msgstr "" #. type: =head2 #: wcd.pod:825 msgid "Windows PowerShell version" msgstr "" #. type: textblock #: wcd.pod:827 msgid "" "Add the following function to your PowerShell user profile. The location of " "this profile is stored in the $profile variable. It is required that one of " "the environment variables I or I is defined." msgstr "" #. type: verbatim #: wcd.pod:831 #, no-wrap msgid "" " function wcd\n" " {\n" " \\wcdwin32psh.exe $args\n" " & $env:HOME\\wcdgo.ps1\n" " }\n" "\n" msgstr "" #. type: textblock #: wcd.pod:837 msgid "" "Replace I with the location where the wcd executable has been " "installed. Start a new PowerShell. Wcd for PowerShell supports only the " "file system provider. No other providers." msgstr "" #. type: =head2 #: wcd.pod:841 msgid "OS/2 Command Prompt version" msgstr "" #. type: textblock #: wcd.pod:843 msgid "" "In an OS/2 Command Prompt (cmd.exe) an OS/2-program can't change the current " "work directory. That is why wcd generates a command script C " "which must be executed in the current shell. The script C first " "executes C, which creates the C script. Then " "C executes the C script." msgstr "" #. type: =head1 #: wcd.pod:850 msgid "LOCALIZATION" msgstr "" #. type: =item #: wcd.pod:854 msgid "B" msgstr "" #. type: textblock #: wcd.pod:856 msgid "" "The primary language is selected with the environment variable I. The " "I variable consists out of several parts. The first part is in small " "letters the language code. The second one is optional and is the country " "code in capital letters, preceded with an underscore. There is also an " "optional third part: character encoding, preceded with a dot. A few examples " "for POSIX standard type shells:" msgstr "" #. type: verbatim #: wcd.pod:863 #, no-wrap msgid "" " export LANG=nl Dutch\n" " export LANG=nl_NL Dutch, The Netherlands\n" " export LANG=nl_BE Dutch, Belgium\n" " export LANG=es_ES Spanish, Spain\n" " export LANG=es_MX Spanish, Mexico\n" " export LANG=en_US.iso88591 English, USA, Latin-1 encoding\n" "\n" msgstr "" #. type: textblock #: wcd.pod:870 msgid "" "For a complete list of language and country codes see the gettext(1) " "manual: " "L On " "Unix systems you can use to command locale(1) to get locale specific " "information." msgstr "" #. type: =item #: wcd.pod:876 msgid "B" msgstr "" #. type: textblock #: wcd.pod:878 msgid "" "With the I environment variable you can specify a priority list of " "languages, separated by colons. Wcd gives preference to I over " "I. For instance, first Dutch and then German: C. You " "have to first enable localization, by setting I or I to a " "value other than I, before you can use a language priority list through " "the I variable. See also the gettext(1) manual: " "L" msgstr "" #. type: textblock #: wcd.pod:886 msgid "" "If you select a language which is not available you will get the standard " "English messages." msgstr "" #. type: =item #: wcd.pod:889 msgid "B" msgstr "" #. type: textblock #: wcd.pod:891 msgid "" "With the environment variable I the I used during " "compilation and installation of wcd can be overruled. I is used " "by wcd with native language support to find the language files. The GNU " "default value is C. By typing C wcd will " "print the I that is used." msgstr "" #. type: textblock #: wcd.pod:897 msgid "" "If you have installed wcd in a different directory than the default " "directory you may need to set the environment variable I to " "point to the locale directory." msgstr "" #. type: textblock #: wcd.pod:902 msgid "An example for Windows cmd:" msgstr "" #. type: verbatim #: wcd.pod:904 #, no-wrap msgid "" " set WCDLOCALEDIR=c:/my_prefix/share/locale\n" "\n" msgstr "" #. type: textblock #: wcd.pod:907 msgid "An example for a POSIX shell:" msgstr "" #. type: verbatim #: wcd.pod:909 #, no-wrap msgid "" " export WCDLOCALEDIR=$HOME/share/locale\n" "\n" msgstr "" #. type: =item #: wcd.pod:911 msgid "B" msgstr "" #. type: textblock #: wcd.pod:913 msgid "" "When there are multiple directory matches wcd presents a sorted list. The " "sorting depends on the locale settings. If the environment I has been " "set the matches are sorted like dictionaries or phone books are sorted in " "that language. For instance dots and dashes are ignored, or letters e with " "and without accent are equal, or upper and lower case is ignored." msgstr "" #. type: textblock #: wcd.pod:919 msgid "" "The sorting gives preference to environment variable I over " "I. If you make I equal to C or C, locale sorting " "is turned off. For instance if you want Dutch language, but not Dutch " "sorting, you can do something like this:" msgstr "" #. type: verbatim #: wcd.pod:924 #, no-wrap msgid "" " export LANG=nl_NL\n" " export LC_COLLATE=C\n" "\n" msgstr "" #. type: =item #: wcd.pod:927 msgid "B" msgstr "" #. type: textblock #: wcd.pod:929 msgid "" "With regard to character encoding Wcd will give preference to variable " "I over I. For instance to set character encoding to UTF-8 " "the following environment setting can be done." msgstr "" #. type: verbatim #: wcd.pod:933 #, no-wrap msgid "" " export LC_CTYPE=en_US.UTF-8\n" "\n" msgstr "" #. type: =item #: wcd.pod:935 msgid "B" msgstr "" #. type: textblock #: wcd.pod:937 msgid "" "All locale environment variables that start with I are overruled by the " "environment variable I if it is defined. Wcd gives preference to " "I over I and I." msgstr "" #. type: =head2 #: wcd.pod:944 msgid "WINDOWS CODE PAGES" msgstr "" #. type: textblock #: wcd.pod:946 msgid "" "There are two groups of code pages: DOS code pages (OEM) and Windows code " "pages (ANSI). The default encoding for Windows, when configured with Western " "regional settings, is ANSI CP1252. Windows programs, for instance notepad, " "use this default system ANSI code page. The Windows console uses by default " "an OEM code page (CP437 or CP850) for compatibility with DOS programs. If " "you use a DOS version of wcd in a Windows console it will work, because of " "the DOS code page. But the DOS version of wcd lacks support for long " "directory names and network drives on Windows." msgstr "" #. type: textblock #: wcd.pod:955 msgid "" "The Windows version of wcd is a native Windows program and will use the " "Windows system ANSI code page. So on a Western regional Windows it will use " "code page CP1252 for directory names and messages. In order to get " "consistent output, independent of the active code page, all Windows versions " "of Wcd translate ANSI output to Unicode output in the Command Prompt and " "PowerShell." msgstr "" #. type: textblock #: wcd.pod:961 msgid "" "The console raster font only supports the original OEM code page installed " "with Windows, so you have to change the console's font to true type Lucida " "Console to make Unicode (and ANSI) letters appear correctly." msgstr "" #. type: textblock #: wcd.pod:965 msgid "" "Non-Unicode versions of Wcd I use plain ANSI " "output. For these older versions the code page of the console has to be " "made equal to the system code page (changed to 1252) to make wcd for Windows " "work properly with special characters such as accented characters or the " "Euro symbol." msgstr "" #. type: textblock #: wcd.pod:970 msgid "" "The Windows system code page can be changed via the Control Panel regional " "options. The Windows console code page is changed with the C command." msgstr "" #. type: textblock #: wcd.pod:973 msgid "" "When you type C, the actual character encoding used by wcd is " "shown. Type the command C to display the active code page of the " "Windows console." msgstr "" #. type: =head2 #: wcd.pod:978 msgid "UNICODE" msgstr "" #. type: textblock #: wcd.pod:980 msgid "" "Wcd has optional support for Unicode. To see if wcd was built with Unicode " "support type C. If your terminal/console and font supports it, you " "should see the Euro symbol and Chinese characters (meaning: \"Chinese\")." msgstr "" #. type: textblock #: wcd.pod:985 msgid "" "Wcd has been I converted to Unicode. In its core wcd handles all data " "as a stream of bytes. Only the lines printed to screen are on the fly " "converted to Unicode wide characters. Wcd fully relies on libc functions and " "has no UTF-8 specific code. See also " "L" msgstr "" #. type: textblock #: wcd.pod:991 msgid "" "Wcd has optional support for Unicode matching with normalisation. To find " "out whether Wcd has normalisation support type C. Wcd with Unicode " "normalization support will match Unicode names based on I " "equivalence. Without Unicode normalization support, names are matched when " "they are binary equivalent. See also " "L" msgstr "" #. type: =head3 #: wcd.pod:998 msgid "UTF-8 on Unix/Linux" msgstr "" #. type: textblock #: wcd.pod:1000 msgid "" "In order to view UTF-8 characters your console/terminal also needs to " "support UTF-8. The xterm version that comes with XFree86 4.0 or higher " "includes UTF-8 support. To activate it, start xterm(1) in a UTF-8 locale and " "use a font with iso10646-1 encoding, for instance with" msgstr "" #. type: verbatim #: wcd.pod:1005 #, no-wrap msgid "" " LC_CTYPE=en_GB.UTF-8 xterm -u8 -fn " "'-Misc-Fixed-Medium-R-SemiCondensed--13-120-75-75-C-60-ISO10646-1'\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1007 msgid "" "Modern distributions of GNU/Linux support UTF-8 by default. Other multi-byte " "character encodings should also work, but that has not been tested." msgstr "" #. type: textblock #: wcd.pod:1010 msgid "" "Wcd assumes that the treedata files are encoded in the locale character " "encoding. There are no Byte Order Marks written to treedata files." msgstr "" #. type: =head3 #: wcd.pod:1014 msgid "UTF-16 on Windows" msgstr "" #. type: textblock #: wcd.pod:1016 msgid "" "On Windows Unicode is supported in all versions of PowerShell, and in " "Windows Command Prompt on Windows 7 (or higher). Unicode also works in Take " "Command or TCC/LE made by JP Software, which can be used on older Windows " "versions (XP/Vista)." msgstr "" #. type: textblock #: wcd.pod:1021 msgid "" "On Windows all the directory names on disk are encoded in UTF-16 Unicode. " "For non-Unicode Windows programs the Unicode characters are translated to " "the default ANSI code page. For characters that are not part of the regional " "setting this translation is not possible and non-Unicode programs print a " "question mark or a wrong character instead." msgstr "" #. type: textblock #: wcd.pod:1027 msgid "" "Wcd with Unicode support will read the UTF-16 encoded directory names and " "converts them internally to UTF-8. All treedata files are encoded in UTF-8 " "and not compatible with the non-Unicode version of Wcd. Wcd will create a " "go-script encoded in UTF-8." msgstr "" #. type: textblock #: wcd.pod:1032 msgid "" "All versions of Windows PowerShell are able to run scripts encoded in UTF-8, " "provided there is an UTF-8 BOM in the script." msgstr "" #. type: textblock #: wcd.pod:1035 msgid "" "Since Windows 7 it is possible in Windows Command Prompt to change directory " "with a batch script to a directory with Unicode letters in the name. The " "directory name needs to be encoded in UTF-8, and the batch script must " "I have a BOM. The active code page of the Command Prompt needs to be " "set to 65001 (UTF-8) prior to the cd command. Wcd for Command Prompt will " "create such a go script C. It first changes the code page to " "65001, then changes directory, and finally sets the code page back to the " "original code page." msgstr "" #. type: textblock #: wcd.pod:1043 msgid "" "You need to set the font to True Type Lucida Console (not raster font) when " "letters don't appear correctly." msgstr "" #. type: textblock #: wcd.pod:1046 msgid "" "The non-Unicode Windows version of Wcd can read Unicode treedata files since " "version 5.2.0, provided there is a Byte Order Mark (BOM) in the file (see " "L), but it can't change to " "directories with Unicode letters in the name that are not part of the " "default system ANSI code page. The Unicode Windows version of wcd writes a " "BOM in the UTF-8 encoded treedata files since version 5.2.0, which makes " "them also readable by notepad." msgstr "" #. type: =head3 #: wcd.pod:1055 msgid "UTF-8 on Cygwin" msgstr "" #. type: textblock #: wcd.pod:1057 msgid "" "Cygwin supports Unicode since version 1.7. The Cygwin layer takes care that " "the Windows UTF-16 Unicode names are converted to UTF-8. So programs, like " "wcd, do not need to be aware of this and can operate using UTF-8 encoding as " "on Unix/Linux. Set character encoding to UTF-8 with the I or " "I environment variable. You may need to rescan your drives. You " "need to set the font to True Type Lucida Console (not raster font) if you " "use the default Cygwin console." msgstr "" #. type: textblock #: wcd.pod:1065 msgid "" "The Cygwin version behaves exactly as the Unix version of wcd. There is no " "BOM written in the treedata files, and it is assumed they are encoded in the " "B locale character encoding." msgstr "" #. type: =head1 #: wcd.pod:1069 msgid "FILES" msgstr "" #. type: textblock #: wcd.pod:1071 msgid "" "If the environment variable I is set wcd will use I " "instead of I. All C<*.wcd> files are text files. They can be edited " "with a text editor. The Windows Command Prompt version of wcd behaves as " "the DOS version. The Cygwin version of wcd behaves as the Unix version." msgstr "" #. type: =item #: wcd.pod:1080 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1082 msgid "" "The program. In Unix shells the program is always called by a function or " "alias, because the current working directory of a Unix shell can only be " "changed by the builtin cd command. See also section INSTALLATION." msgstr "" #. type: =item #: wcd.pod:1087 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1089 msgid "" "This is the default treedata file where wcd searches for matches. If it is " "not readable wcd will create a new one." msgstr "" #. type: verbatim #: wcd.pod:1092 #, no-wrap msgid "" " DOS: \\treedata.wcd or %HOME%\\treedata.wcd\n" " Unix: $HOME/.treedata.wcd\n" "\n" msgstr "" #. type: =item #: wcd.pod:1095 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1097 msgid "" "An optional extra treedata file. If it exists and is readable wcd will try " "to find matches in this file also." msgstr "" #. type: verbatim #: wcd.pod:1100 #, no-wrap msgid "" " DOS: \\extra.wcd or %HOME%\\extra.wcd\n" " Unix: $HOME/.extra.wcd\n" "\n" msgstr "" #. type: =item #: wcd.pod:1103 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1105 msgid "" "In this optional file wcd places banned paths. See option B<-b>. Wildcards " "are supported." msgstr "" #. type: verbatim #: wcd.pod:1108 #, no-wrap msgid "" " DOS: \\ban.wcd or %HOME%\\ban.wcd\n" " Unix: $HOME/.ban.wcd\n" "\n" msgstr "" #. type: =item #: wcd.pod:1111 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1113 msgid "Optional file with wcd aliases. See option B<-l>." msgstr "" #. type: verbatim #: wcd.pod:1115 #, no-wrap msgid "" " DOS: \\alias.wcd or %HOME%\\alias.wcd\n" " Unix: $HOME/.alias.wcd\n" "\n" msgstr "" #. type: =item #: wcd.pod:1118 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1120 msgid "" "In this file wcd stores its stack. The drive letter can be changed with the " "B<-d> option." msgstr "" #. type: verbatim #: wcd.pod:1123 #, no-wrap msgid "" " DOS: c:\\stack.wcd or %HOME%\\stack.wcd\n" " Unix: $HOME/.stack.wcd\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1126 msgid "" "The name of the stack file can be changed with environment variable " "I. See section ENVIRONMENT VARIABLES." msgstr "" #. type: =item #: wcd.pod:1129 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1131 msgid "" "This is the shell script which wcd.exe creates each time. It is sourced via " "a function or an alias. The drive letter can be changed with the B<-d> " "option. For history reasons it is placed by default in C<$HOME/bin> on Unix " "systems. The directory of this file can be changed with the option B<-G>." msgstr "" #. type: verbatim #: wcd.pod:1136 #, no-wrap msgid "" " DOS bash: c:/wcd.go or $HOME/wcd.go\n" " Windows Command Prompt: c:\\wcdgo.bat or %HOME%\\wcdgo.bat\n" " Windows PowerShell: $env:HOME\\wcdgo.ps1\n" " WinZsh: $HOME/wcd.go\n" " Cygwin/MSYS: $HOME/bin/wcd.go\n" " OS/2 Command Prompt: c:\\wcdgo.cmd or %HOME%\\wcdgo.cmd\n" " OS/2 bash: c:/wcd.go or $HOME/wcd.go\n" " Unix: $HOME/bin/wcd.go\n" "\n" msgstr "" #. type: =item #: wcd.pod:1145 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1147 msgid "" "Text file with relative paths from I. See options B<+S>, B<-n> and " "B<+n>." msgstr "" #. type: verbatim #: wcd.pod:1150 #, no-wrap msgid "" " DOS: \\rtdata.wcd\n" " Unix: /.rtdata.wcd\n" "\n" msgstr "" #. type: =head1 #: wcd.pod:1155 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: =item #: wcd.pod:1159 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1161 msgid "" "Wcd uses by default environment variable I to determine where to store " "its files. See also section FILES. This can be overruled with environment " "variable I." msgstr "" #. type: textblock #: wcd.pod:1165 msgid "" "I also defines where to start scanning the disk when option B<-s> is " "used. This can be overruled with the environment variable I." msgstr "" #. type: textblock #: wcd.pod:1169 msgid "" "For the Unix, Cygwin, Windows PowerShell, WinZsh and MSYS version it is " "required that I or I is set. For the other versions of wcd " "the use of these variables is optional." msgstr "" #. type: textblock #: wcd.pod:1173 msgid "" "If I is set on DOS/Windows, wcd will place all its files " "(treedata.wcd, extra.wcd, alias.wcd, ban.wcd, wcd.go) in directory " "I. The behaviour of wcd is then equal to the Unix version of wcd. Wcd " "will scan the disk default from I. Drives will not be automatically " "scanned by changing to them. You need to tell wcd explicitly. E.g.:" msgstr "" #. type: verbatim #: wcd.pod:1180 #, no-wrap msgid "" " wcd -S c: -A d: -A e:\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1182 msgid "Matching of directories is now global over all scanned drives." msgstr "" #. type: =item #: wcd.pod:1185 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1187 msgid "" "Environment variable I can be used to change the location of wcd's " "files. If both I and I are set, I will be used " "instead of I." msgstr "" #. type: textblock #: wcd.pod:1191 msgid "" "In wcd versions prior to 5.1.5 I also changed the default scan " "directory. This has changed. Since version 5.1.5 I does not change " "the default scan directory. See option B<-s>. From version 5.1.5, use " "environment I to overrule the default scan directory." msgstr "" #. type: textblock #: wcd.pod:1196 msgid "Example for DOS, Windows, OS/2 Command Prompt:" msgstr "" #. type: verbatim #: wcd.pod:1198 #, no-wrap msgid "" " set WCDHOME=C:\\Users\\erwin\\wcd\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1200 wcd.pod:1221 wcd.pod:1241 wcd.pod:1266 msgid "An example for POSIX type shells:" msgstr "" #. type: verbatim #: wcd.pod:1202 #, no-wrap msgid "" " export WCDHOME=\"$HOME/.wcd\"\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1204 wcd.pod:1225 wcd.pod:1245 wcd.pod:1270 msgid "An example for Csh type shells:" msgstr "" #. type: verbatim #: wcd.pod:1206 #, no-wrap msgid "" " setenv WCDHOME \"$HOME/.wcd\"\n" "\n" msgstr "" #. type: =item #: wcd.pod:1208 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1210 msgid "" "Use environment variable I to overrule the default scan directory " "I. Define a colon separated list (Unix) to define more than one " "directory. On DOS/Windows make the list semi-colon separated." msgstr "" #. type: textblock #: wcd.pod:1215 msgid "Examples for DOS, Windows, OS/2 Command Prompt:" msgstr "" #. type: verbatim #: wcd.pod:1217 #, no-wrap msgid "" " set WCDSCAN=C:\\Users\\erwin;D:\\data\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1219 #, no-wrap msgid "" " set WCDSCAN=%HOMEDRIVE%%HOMEPATH%;\\\\projectdrive\\projectX\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1223 #, no-wrap msgid "" " export WCDSCAN=\"$HOME:/projectdisk/projectX\"\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1227 #, no-wrap msgid "" " setenv WCDSCAN \"$HOME:/projectdisk/projectX\"\n" "\n" msgstr "" #. type: =item #: wcd.pod:1229 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1231 msgid "" "Specify filters with environment variable I. All directories that " "do not match the filter(s) are ignored. A list can be specified by " "separating filters by the shell path separator. Similar as specifying the " "I variable. The case sensitivity is mandated by the Operating system." msgstr "" #. type: textblock #: wcd.pod:1237 wcd.pod:1262 msgid "An example for DOS, Windows, OS/2 Command Prompt:" msgstr "" #. type: verbatim #: wcd.pod:1239 #, no-wrap msgid "" " set WCDFILTER=projects;doc\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1243 #, no-wrap msgid "" " export WCDFILTER=\"projects:doc\"\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1247 #, no-wrap msgid "" " setenv WCDFILTER \"projects:doc\"\n" "\n" msgstr "" #. type: =item #: wcd.pod:1249 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1251 msgid "" "The paths specified with environment I will be banned by wcd. See " "also option B<-b>. Specify a list of paths separated by shell I " "separator." msgstr "" #. type: =item #: wcd.pod:1255 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1257 msgid "" "The paths specified with environment I will be excluded by " "wcd. See also options B<-x> and B<-xf>. Specify a list of paths separated by " "shell I separator." msgstr "" #. type: verbatim #: wcd.pod:1264 #, no-wrap msgid "" " set WCDEXCLUDE=*/windows;*/temp;*CVS\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1268 #, no-wrap msgid "" " export WCDEXCLUDE=\"/dev:/tmp:*CVS\"\n" "\n" msgstr "" #. type: verbatim #: wcd.pod:1272 #, no-wrap msgid "" " setenv WCDEXCLUDE \"/dev:/tmp:*CVS\"\n" "\n" msgstr "" #. type: =item #: wcd.pod:1274 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1276 msgid "" "Set the base of user's home directories. On DOS/Windows the default value " "is C<\\\\users>. On Unix/Cygwin the default value is C. This " "variable is used to scan treedata files of other users. See also options " "B<-u> and B<+u>. In verbose mode wcd will print all filters, bans and " "excludes. See option B<-v>." msgstr "" #. type: =item #: wcd.pod:1283 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1285 msgid "" "Wcd gives preference to I over the default stack file name " "(see section FILES). With this variable each shell (or used terminal " "emulator) can have its private stack of used directories." msgstr "" #. type: textblock #: wcd.pod:1289 msgid "" "To use a unique time based YYYYMMDD-HHMMSS file for each opened interactive " "shell." msgstr "" #. type: verbatim #: wcd.pod:1292 #, no-wrap msgid "" " export WCDSTACKFILE=$HOME/.wcd/stack.$(date +%Y%m%d-%H%M%S)\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1294 msgid "For a stack per xterm(1), use the xterm I environment variable:" msgstr "" #. type: verbatim #: wcd.pod:1296 #, no-wrap msgid "" " export WCDSTACKFILE=$HOME/.wcd/stack.$WINDOWID\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1298 msgid "For GNU screen(1), to use stack per screen:" msgstr "" #. type: verbatim #: wcd.pod:1300 #, no-wrap msgid "" " export WCDSTACKFILE=$HOME/.wcd/stack.$WINDOW\n" "\n" msgstr "" #. type: =item #: wcd.pod:1302 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1304 msgid "" "If the environment variable I is defined, wcd with ncurses " "interface checks for a local terminal definition before checking in the " "standard place. This is useful if terminal definitions are not on a standard " "place. Often used standard places are C and " "C." msgstr "" #. type: =item #: wcd.pod:1310 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1312 msgid "" "Wcd with PDCurses interface recognizes the environment variable " "I. If this environment variable is set, PDCurses will " "take a copy of the contents of the screen at the time that wcd is started; " "when wcd exits, the screen will be restored. An example for Windows Command " "Prompt:" msgstr "" #. type: verbatim #: wcd.pod:1318 #, no-wrap msgid "" " set PDC_RESTORE_SCREEN=1\n" "\n" msgstr "" #. type: textblock #: wcd.pod:1320 msgid "" "Windows allows only a small buffer to be saved. So it is not always possible " "to restore everything. Some garbage data may be printed in the console after " "wcd exists if you have set a large buffer width." msgstr "" #. type: =item #: wcd.pod:1325 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1327 msgid "" "Printing of C<#!$SHELL> on the first line of the go-script for POSIX type " "shell or C shell is needed for 8 bit characters. Some shells otherwise think " "that the go-script is a binary file and will not source it. In Cygwin Bash " "the variable I must be set in environment using the C " "command, otherwise wcd can't read the variable." msgstr "" #. type: =item #: wcd.pod:1335 msgid "B" msgstr "" #. type: textblock #: wcd.pod:1337 msgid "" "Wcd for DOS bash uses C<$BASH> instead of C<$SHELL>, because C<$SHELL> " "points to the DOS command shell. One may need to define C<$BASH> with an " "C command, otherwise wcd can't read the variable." msgstr "" #. type: =head1 #: wcd.pod:1344 msgid "SEE ALSO" msgstr "" #. type: textblock #: wcd.pod:1346 msgid "sh(1), bash(1), csh(1), ksh(1), zsh(1), locale(1), ncurses(1)," msgstr "" #. type: =head1 #: wcd.pod:1354 msgid "AUTHORS" msgstr "" #. type: textblock #: wcd.pod:1356 msgid "Wcd was written by Erwin Waterlander " msgstr "" #. type: textblock #: wcd.pod:1358 msgid "Project homepage: L" msgstr "" #. type: textblock #: wcd.pod:1361 msgid "SourceForge: L" msgstr "" #. type: textblock #: wcd.pod:1364 msgid "" "The manual page formatting was provided by Jari Aalto " "." msgstr "" #. type: textblock #: wcd.pod:1367 msgid "" "NCD was originally written by Brad Kingsbury for Peter Norton's \"Norton " "Utilities\" around 1987. See also " "L" msgstr ""