11.. IInnttrroodduuccttiioonn Type CCttrrll+gg (type gg while holding the CCttrrll key) to return to the table of contents. Move the cursor with the following keys and press EEnntteerr to see its content: CCttrrll+pp : Move cursor one line up CCttrrll+nn : Move cursor one line down You can move the cursor to the previous or the next section by press- ing `;;' or `::' key, respectively in this page. (You can use keys described in the KKEEYY window that will be displayed by CCttrrll+hh key.) The following notations are used in this document. Keyboard _T_c_b(1) commands generally involve the CCttrrll key. ^^HH : CCttrrll+hh ^^JJ^^HH : ^^JJ, release it, then ^^HH ^^JJbb : ^^JJ, release it, then bb ^^XX^^KKee : ^^XX, release it, then ^^KK, release it, and then ee The EEnntteerr and EEsscc keys can be used in place of ^^MM and ^^[[, respectively. String The outputted messages by _t_c_b(1) are shown within parentheses "", the strings inputted from the keyboard excluding ^^MM (abbreviation for `CCttrrll+mm') are shown within parentheses `' and other terms are shown within parentheses ``''. Program name The manual page for the programs such as ``ls'' (displayed as _l_s(1)), which will be executed by _t_c_b(1), can be referred by typing ^^JJmm and then `1 ls EEnntteerr' (or just `ls EEnntteerr') at the bottom of the window. File name A file that has no manual page is displayed as a _f_i_l_e without a section No.. The _f_i_l_e name ends with ``/'' denotes a directory. ``~'' is also a directory name that will be displayed by typing `echo $HOME EEnntteerr'. The files excluding the special devices in _/_d_e_v_/ and directories are displayed as ``regular-file''. Mode name A boldfaced string written in capital letters such as SSHHEELLLL denotes a mode name that will be described in the FFiillee mmaannaaggeerr's section. _T_c_b(1) can be started with either following mode. (This mode name is displayed on the line begins with the string ``Startup mode:'' in the TTCCBB window of KKEEYY.) ppaaggeerr _T_c_b(1) will work as a ppaaggeerr when it is started with a pipe (`ls -l | tcb EEnntteerr' etc.) or a _f_i_l_e (regular-file) argument (`tcb file EEnntteerr'). In this mode, you can utilize only part of ffiillee mmaannaaggeerr's functions described in the following section. (You can refer to those in the KKEEYY window displayed with ppaaggeerr.) ffiillee mmaannaaggeerr When _t_c_b(1) is started with no argument (`tcb EEnntteerr') or a directory name (`tcb . EEnntteerr' etc.), it will work as a ffiillee mmaannaaggeerr. On the LLiinnuuxx version, --88 or --99 option may be used. For example `tcb -8 (-9) tcb . EEnntteerr' will start with current directory argument on a 8th (or 9th) terminal. When started with no argument, _t_c_b(1) will save the access history's lists to _~_/_._t_c_b_/_h_i_s_t_o_r_y when terminated. Refer to the EEXXIITT's section for details. 22.. KKEEYY [ ^^HH ] _T_c_b(1) will display key functions defined in _t_c_b_r_c. ("(M)" is a mark of built-in macro definition defined in ``M-?'' of ``KEY'' in _t_c_b_r_c.) EEnntteerr on the ^^GG-line will only return to the previous mode. Other line will return to the mode which has called KKEEYY and then execute the specified key definition. 33.. FFiillee mmaannaaggeerr _T_c_b(1) will display following mmooddee--lliinnee at the bottom of the _t_c_b window. tcb.1 01/66 43% 2000 (groff) /home/user/sources/tcb-1.4a/doc/ ~~~~~ ~~~~~ ~~ ~~~~ ~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [[11]] [[22]] [[33]] [[44]] [[55]] [[66]] The columns denote the following items. [[11]] : access-name [[22]] : current-line / total-lines [[33]] : current-page / total-pages * 100 [[44]] : display-size [[55]] : program-name [[66]] : previous-mode The keys described in the WWiinnddooww of the KKeeyy ffuunnccttiioonn's section can be used for window controls such as scrolling. Once _t_c_b(1) is started, pressing ^^JJ^^KK will bring up a ffiillee--sseelleeccttoorr for the current directory. Pressing ^^JJ and then 00 ... 99 will change the current directory to the one specified by the left side of 0 ... 9th ``/''. For example, in the following directory: _/_h_o_m_e_/_u_s_e_r_/_s_o_u_r_c_e_s_/_t_c_b_-_1_._4_a_/_s_r_c_/, ^^JJ22 will change the current directory to _/_h_o_m_e_/_u_s_e_r_/. If ^^OO^^KK is pressed instead of ^^JJ22, it will change the current directory to the following parent directory: _/_h_o_m_e_/_u_s_e_r_/_s_o_u_r_c_e_s_/_t_c_b_-_1_._4_a_/. On the mmooddee--lliinnee, if the cursor is positioned at the end of filename which begins with ``/'', the above key stroke will change the current directory to the corresponding one in the file. For example, `^^XXff/usr/local/lib/tcb/tcbrc EEnntteerr', and then ^^XX^^FF will display the following directory path in the mmooddee--lliinnee: _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_t_c_b_/_t_c_b_r_c. By hitting ^^JJ22, the current directory changes to the following: _/_u_s_r_/_l_o_c_a_l_/. 33..11.. FFiillee--sseelleeccttoorr _T_c_b(1) will execute _l_s(1) and display the content of the current directory. Once the cursor is on the desired line, its file means can be selected by the following keys. ^^MM (EEnntteerr) The line begins with ``-'' (e.g. "-rwxr-xr-x ...") denotes a regular-file. By hitting this key, _t_c_b(1) will read its content into a buffer and display it. ``d'' (e.g. "drwxr-xr-x ...") denotes a directory. This key stroke will change the current directory to that one. _._._/ denotes the parent directory. For example, the current directory _/_t_m_p_/ will change to _/. By choosing _._/ (or ^^JJ^^KK), the displayed content of the current directory will be renewed. ^^OO^^MM By selecting regular-file with this key, the content will be read up to the window size. MMAANN and "(stdin)" mode which will be described later also display the buffer content in the same manner as this mode. Those modes use the same memory area. Entering one mode will clear the content of the other. ^^[[^^MM This key will display the control characters under 0x20 and 0x7f in highlight. (e.g. 0x0d will be displayed by a highlighted character "M".) It will convert the codes above 0x80 to a highlighted character "*". ^^JJbb or ^^JJ^^BB These keys will change the mode to the CCUUTT which will be described later. ^^GG will change the mode to the ffiillee--sseelleeccttoorr and ^^JJ^^JJ will change the current mode to the previous regular-file in all the above modes. ^^XX^^WW will save the content of the current buffer to the file _~_/_._t_c_b_/_w_._t_c_b_. If a regular-file has one of the following suffixes, _t_c_b(1) will execute the program defined in _t_c_b_r_c which will be described in the FFiillee's section. The regular-file written in a ms-macro style such as manual pages will be formatted by _g_r_o_f_f(1) even if the file has no specific suffix. The option of _g_r_o_f_f(1) will be set to ``GROFF'' that is defined in the source file _c_o_n_f_i_g_._s_h. ..ttaarr ..ttggzz ..llzzhh ..zziipp These archive files will be expanded into the memory and their contents will be read into a buffer as is. Depending on the environment, _t_c_b(1) might fail to allocate the buffer. If the buffer capacity is defined in _t_c_b_r_c, _t_c_b(1) will expand it only up to the defined buffer size which may not be enough for complete expansion. In the above instance _t_c_b(1) will display the message "NNoott eennoouugghh bbuuffffeerr". (The content of the files on the lower part of the list will be displayed as "_N_o _s_i_z_e".) ..ggzz ..ddvvii _T_c_b(1) will execute the other programs such as _g_z_i_p(1) and _d_v_i_2_t_t_y(1) to display plain texts. ..hhttmmll ..iinnffoo _T_c_b(1) will launch the other programs such as _l_y_n_x(1) and _i_n_f_o(1) but will not display the content of the file in the _t_c_b window. _T_c_b(1) provides modes that will be described in the following section. The previous mode or the previous filename displayed at the mmooddee--lliinnee [[66]] will be brought back by hitting ^^GG. By pressing ^^JJ^^KK, it always functions as a ffiillee--sseelleeccttoorr. 33..22.. FFGGRREEPP // EEGGRREEPP [ ^^SS / ^^JJ^^SS ] The string inputted at the mmooddee--lliinnee or selected from the list of search-strings will be searched by _f_g_r_e_p(1) or _e_g_r_e_p(1). (_f_g_r_e_p(1) will search the string as is without regular expression.) The search result will be displayed in the list of matched strings and pressing EEnntteerr will take you to the specified line within the buffer. While executing _f(_e)_g_r_e_p(1), any key will interrupt the execution and the message "IInntteerrrruupptteedd" will be displayed. The control characters under 0x20 can be inputted with ^^QQ. (eg. 0x08 can be inputted with ^^QQ^^HH.) You can input a new string with ^^UU key at the mmooddee--lliinnee. As for the other editorial keys, refer to the CCoommmmaanndd-- lliinnee of the KKeeyy ffuunnccttiioonn's section. 33..33.. CCUUTT [ ^^JJcc or ^^JJ^^CC ] _T_c_b(1) will split the content of the current buffer at the lines that contain the string inputted at the mmooddee--lliinnee or selected from the list of search-strings and make a table of contents. In the ffiillee--sseelleeccttoorr, ^^JJbb or ^^JJ^^BB will split a regular-file before reading its content into the buffer. (^^JJcc or ^^JJ^^CC that means splitting output of _l_s(1) can't be executed in the ffiillee--sseelleeccttoorr.) The following regular expressions are used in the default setting for search-string that will be displayed by typing ^^JJ^^CC or ^^JJ^^BB. (Refer to the manual page of _e_g_r_e_p(1) to see other regular expressions.) [[00--99]] any single digit from 0 to 9 ^^ beginning of line $$ end of line .. any single character \\.. ``.'' character ** repeat zero or more times ++ repeat one or more times For example, the HHEELLPP splits the content of the file _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_t_c_b_/_H_E_L_P at the string "^ [0-9]^^HH[0-9]+\.". The operation can be executed by typing following: `^^JJbb^ [0-9]^^QQ^^HH[0-9]+\.EEnntteerr' After reading the content into a buffer with ^^MM in the ffiillee--sseelleeccttoorr, type following: `^^JJcc^ [0-9]+\.EEnntteerr' The key `;;' or `::' will move the cursor to the previous or the next line. `++', `**' will move to the specific line after search-string on the table of contents. If the content of the previous regular-file had been referred by the CCUUTT, hitting ^^JJ^^JJ will bring back the table of contents in order to differentiate the mode. 33..44.. DDUU [ ^^JJdd or ^^JJ^^DD ] _T_c_b(1) will execute _d_u(1) at the SSHHEELLLL (virtual terminal described later) to display the content of the current directory and its sub directories. (Hit EEnntteerr key on the message which will be displayed when _d_u(1) exit.) ^^JJ^^DD will not execute _d_u(1) again but change the display back to the DDUU window. 33..55.. LLOOCCAATTEE [ ^^JJll or ^^JJ^^LL ] _T_c_b(1) will execute _l_o_c_a_t_e(1) to search for the filename that contains the string inputted at the mmooddee--lliinnee. For example, `.tgz EEnntteerr' will display all the filenames contained in the system which have the suffix ..ttggzz. ^^JJ^^LL will not execute _l_o_c_a_t_e(1) again but change the display back to the LLOOCCAATTEE window. This function will not work immediately after the installation of the operating system. Execute _u_p_d_a_t_e_d_b(1) (that is usually executed by _c_r_o_n(8)) or _l_o_c_a_t_e_._u_p_d_a_t_e_d_b(8) as a super user before using this function. 33..66.. PPRROOGGRRAAMM [ ^^JJpp or ^^JJ^^PP ] _T_c_b(1) will launch the program inputted at the mmooddee--lliinnee or selected from the list of program names. (The content of the list can be defined in _t_c_b_r_c.) If the program name inputted with ^^JJpp doesn't exist in the list, _t_c_b(1) will change the mode to the SSHHEELLLL and execute the program. If the string inputted at the SSHHEELLLL-prompt exists in the list, it will be launched in this mode. 33..77.. MMAANN [ ^^JJmm or ^^JJ^^MM ] _T_c_b(1) will display the manual page inputted at the mmooddee--lliinnee or selected from the list of previously accessed manual pages. 33..88.. FFIILLEE // DDIIRR [ ^^XXff or ^^XX^^FF / ^^XXdd or ^^XX^^DD ] _T_c_b(1) will read the content of the file inputted at the mmooddee--lliinnee or selected from the list of previously accessed files. ^^RR will change the mode to the HHIISSTTOORRYY in this window. In the FFIILLEE list, the filename followed by "(program name)" denotes the program which was used by _t_c_b(1) for display. The string used at the CCUUTT will be displayed within parentheses "". The file selected by ^^OO^^MM or ^^[[^^MM in the ffiillee--sseelleeccttoorr will be assumed as a temporary file and will not be saved to the FFIILLEE list. Hitting ^^JJ^^JJ will not return to the window. 33..99.. HHIISSTTOORRYY // CCOOMMMMAANNDD [ ^^RR / ^^JJ^^RR ] The program-names that have been executed at the SSHHEELLLL-prompt are saved to the string-list of HHIISSTTOORRYY and CCOOMMMMAANNDD. The CCOOMMMMAANNDD list can be reffered by ^^JJ^^RR in any modes. The access history will be displayed by pressing ^^RR in the FFIILLEE, DDIIRR, MMAANN, LLOOCCAATTEE, FF(EE)GGRREEPP and CCUUTT. The history of executed programs will be displayed in the other modes. A string will be saved in the order of execution in the HHIISSTTOORRYY list. The keys `^^JJ..', `^^JJ,,' and only the strings that have been inputted at the SSHHEELLLL-prompt via keyboard will be saved after sorting and elimination of overlap in the CCOOMMMMAANNDD list. 33..1100.. CCPP // MMVV // RRMM // AARRCC [ ^^XXcc / ^^XXmm / ^^XXrr / ^^XX^^KKaa ] or [ ^^XX^^KKcc / ^^XX^^KKmm / ^^XX^^KKrr / ^^XX^^KKaa ] These modes can be executed in the ffiillee--sseelleeccttoorr or the DDUU. In CCPP, MMVV and RRMM, a destination file (or operation at RRMM) can be inputted by marking filenames by ^^MM and then typing ^^XX^^MM. _T_c_b(1) will execute _c_p(1), _m_v(1) and _r_m(1) with each argument. _R_M will also delete any line at FFIILLEE, DDIIRR, MMAANN, EEGGRREEPP and CCOOMMMMAANNDD. (As _d_u(1) will not be executed again after RRMM in DDUU, selecting a deleted file will cause an error.) AARRCC will expand an archive file using _t_a_r(1), _l_h_a(1) and _u_n_z_i_p(1). For the files of unknown content, confirm the content of the archive file with ^^OO^^MM before specifying the destination of the expansion. For example, ^^OO^^MM will display the content of _t_c_b_-_1_._4_a_._t_a_r_._g_z as follows in the ffiillee--sseelleeccttoorr: "-rw-r--r-- user/users 500 Jan 1 00:00 1998 tcb-1.4a/Makefile" "-rw-r--r-- user/users 2500 Jan 1 00:00 1998 tcb-1.4a/README" "........" If `/tmp EEnntteerr' is given as an answer to the "Destination ?" (specifying destination file) question, the file will be expanded to the directory _/_t_m_p_/_t_c_b_-_1_._4_a_/. (If ``/tmp'' is not a directory, it will cause an error.) ^^WW will display the previous directory-name on the line "Destination ?". AARRCC can only expand the specific files in the archive window. In the above example, in the following archive window of _t_c_b_-_1_._4_a_._t_a_r_._g_z displayed with ^^MM at the ffiillee--sseelleeccttoorr, "-rw-r--r- 500 tcb-1.4a/Makefile" "-rw-r--r- 2500 tcb-1.4a/README" "........" after typing ^^XX^^KKaa in the window and marking the above two lines with ^^MM, typing `^^XX^^MM/tmp EEnntteerr' (an answer to "Destination ?") will expand them as follows: _/_t_m_p_/_t_c_b_-_1_._4_a_/_M_a_k_e_f_i_l_e _/_t_m_p_/_t_c_b_-_1_._4_a_/_R_E_A_D_M_E ^^XX^^YY will mark all filenames and ^^XX^^NN will clear all the marks. However, they will not work if the intended operation is in conflict with the file permissions. (e.g. a general user tries to delete a read-only file which belongs to the other user.) While executing _c_p(1) and others, the program sometimes waits for the process input due to a file permission. If you have activated CCPP with ^^XXcc, type ^^GG and switch to the SSHHEELLLL with ^^[[ss and then specify the operation. `,,' or `..' will mark the current line and move cursor to the previous or the next line. `<<' or `>>' can select the specific lines. For example, if you want to delete filenames end with a character ``~'' (ordinarily a backup file), switch to the RRMM and search for `~$' by EEGGRREEPP. Type EEnntteerr to move cursor to the first line ending with ``~''. In this window, `>>' selects the desired line. The above functions will not work while the other programs are operating at the SSHHEELLLL-prompt. 33..1111.. SSHHEELLLL [ ^^[[ss or ^^XXss or ^^JJ.. or ^^JJ,, or ^^JJww or ^^JJ^^WW ] By pressing ^^[[ss, the _t_c_b window will be switched to the virtual terminal of the rogin-_s_h_e_l_l or the _s_h_e_l_l defined in _t_c_b_r_c. If the virtual terminal starts to behave erratically, you can restart the shell by typing ^^XXss. ^^JJ.. or ^^JJ,, will set the current directory of the SSHHEELLLL as the position of the ffiillee--sseelleeccttoorr. (^^JJ,, will execute `ls -l' at the SSHHEELLLL-prompt.) By pressing ^^JJww or ^^JJ^^WW and then EEnntteerr, the mmooddee--lliinnee [[11]] (access- name) or the content of the buffer will be shown. ^^WW will restart this command at the SSHHEELLLL-prompt. If there is an ongoing program and input cannot be made at the prompt, the functions that use the SSHHEELLLL-prompt such as CCPP or MMVV etc. will not work. For example, after `man bash EEnntteerr' was made at the SSHHEELLLL-prompt, the prompt will not return until the end of output since the output from _m_a_n(1) was inputted to _t_c_b(1) via pipe. The prompt will be back by moving to the end of the file with ^^[[>>. At any mode other than the SSHHEELLLL, _t_c_b(1) will display the message "EExxiitt" (can be clear by ^^LL) when the SSHHEELLLL-prompt returns. When started with a file argument or a pipe at the SSHHEELLLL-prompt, _t_c_b(1) will display the content with access-name "file" or "(stdin)". (e.g. `tcb . EEnntteerr' will start the ffiillee--sseelleeccttoorr for the current directory. Above `man bash EEnntteerr' will be "(stdin)", bacause the output will be inputted to _t_c_b(1) via a pipe by means of ``PAGER'' environment variable.) In this function, the _s_h_e_l_l process-ID is used for the authentication of the regular-file or _s_o_c_k_e_t(2) used for switching to the window of "file" or "(stdin)". Therefore, if you have executed _s_u(1) etc. at the SSHHEELLLL-prompt, the window will not be switched from that particular prompt. The programs such as editor and pager which changes the terminal settings will not function normally if they are not defined in the PPRROOGGRRAAMM list. If you have accidentally activated those programs, _k_i_l_l(1) them after interruption by ^^CC or suspension by ^^ZZ. The commands inputted at the SSHHEELLLL-prompt will be given to the _s_h_e_l_l after edited by the keys described in the CCoommmmaanndd--lliinnee of the KKeeyy ffuunnccttiioonn's section. However, on an interactive program such as _f_t_p(1), _t_c_b(1) will exchange the data per one character bases with the _s_h_e_l_l. In those instances, you can use the keys described in the IInntteerraaccttiioonn of the KKeeyy ffuunnccttiioonn's section. In actuality, you can use the keys of the CCoommmmaanndd--lliinnee on the line begins with the string "ttccbb vv11..44aa:...". (i.e. the environment variable ``PS1''.) The keys of the IInntteerraaccttiioonn can be used on the other lines. Therefore, once you execute a program at the SSHHEELLLL-prompt, the keys excluding the IInntteerraaccttiioonn can't be used until the prompt returns. Apart from ^^RR and ^^JJ^^RR, the program can be restarted by moving the cursor to the particular prompt line in the previously executed prompts and type EEnntteerr. 33..1122.. LLIISSTT [ ^^II or TTaabb ] By typing ^^II while inputting a string at SSHHEELLLL-prompt or mmooddee--lliinnee, _t_c_b(1) will display a filename that contains the string. If there are more than one corresponding files in the current directory, it will be indicated by beep sound. When it happens, type ^^II again and you will get the list of the filenames. For example, if _t_c_._c and _t_c_b_._c are included in the directory, _t_c_b(1) will sound beep after typing `^^XXfftc', ^^II because there are more than one match. By choosing either _t_c_._c or _t_c_b_._c from the list that will be displayed by typing ^^II again, the desired filename will be inserted to the cursor positon. At SSHHEELLLL, PPRROOGGRRAAMM and MMAANN, the first string will be assumed as a program name and searched through ``PATH'' environment variable (directory-list where executable files locate.) However, if the string is followed by a space character, _t_c_b(1) will complement the filename on the current directory and pass it to the program. In the above example, if _t_c_b, _t_c_l_s_h and _t_c_s_h exist on ``PATH'', typing `tc', ^^II will display the list of these executable filenames. On the other hand, ``tc'' will be considered as an executable file when you type ^^II after `tc '. The filename will be given to ``tc'' after being complemented from the corrent directory. FFIILLEE or DDIIRR will not search for program names on ``PATH''. DDIIRR complements directory names only. 33..1133.. EEDDIITT If the mmooddee--lliinnee [[11]] (access-name) is a regular-file and the mmooddee--lliinnee [[55]] (program-name) is blank, _t_c_b(1) will launch the editor defined in _t_c_b_r_c. _T_c_b(1) will launch the editor to which the current line number ``N'' will be given with ``+N'' option. It is convenient to set the editor that has this option. Default editor is _v_i(1). 33..1144.. EERRRROORR [ ^^XX^^KKee ] When an error occurs especially when the program terminates abnormally as a child process, the message "IInnvvaalliidd aarrgguummeenntt" will be displayed. The standard error output from the child process will be saved to EERRRROORR. 33..1155.. LLOOGG [ ^^XX^^KKll ] This mode will display SSHHEELLLL's log. 33..1166.. EEXXIITT [ ^^XX^^CC or ^^[[^^[[ ] _T_c_b(1) maintains a file-list that contains information on the previously accessed files concerning the cursor position, total lines and the like. If you start _t_c_b(1) with no argument and then terminate with EEXXIITT, you can use the file-list continually at the next execution. (EEXXIITT will save the file-list to _~_/_._t_c_b_/_h_i_s_t_o_r_y.) _T_c_b(1) will also save the content of EERRRROORR and LLOOGG to _~_/_._t_c_b_/_e_r_r_o_r and _~_/_._t_c_b_/_s_h_e_l_l, respectively. When started with a directory argument or used as a ppaaggeerr, _t_c_b(1) will not access above files. 44.. FFiillee _T_c_b(1) will read _~_/_._t_c_b_/_t_c_b_r_c and set environment when started. If the file doesn't exist, _t_c_b(1) will read _t_c_b_r_c from _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_t_c_b_/. If this file is newer than _~_/_._t_c_b_/_t_c_b_r_c, _t_c_b(1) will display the message "~~//..ttccbb//ttccbbrrcc iiggnnoorreedd". The following is the content defined in _t_c_b_r_c. ARC format : ssuuffffiixx _a_r_c_h_i_v_e_r (option) example : .tar tar tvf The _a_r_c_h_i_v_e_r of _t_a_r(1), _l_h_a(1) and _u_n_z_i_p(1) will display the content of the archive file that has the ssuuffffiixx. In the archive content window, the _a_r_c_h_i_v_e_r will display the content of the regular-file with the ssuuffffiixx as a plain text. FILE format : ssuuffffiixx _p_r_o_g_r_a_m (option) example : .gz gzip -dc The _p_r_o_g_r_a_m will display the content of the regular-file with the ssuuffffiixx as a plain text. EXEC format : ssuuffffiixx _p_r_o_g_r_a_m (option) example : .html lynx The _p_r_o_g_r_a_m will be launched with argument of file that has the ssuuffffiixx. GREP format : ssttrriinngg example : \/\*tcb\*\/ The ssttrriinngg that will be used in EEGGRREEPP or CCUUTT. PROGRAM format : _p_r_o_g_r_a_m example : dviout The _p_r_o_g_r_a_m that will be launched by PPRROOGGRRAAMM. EDITOR format : _e_d_i_t_o_r example : vi The _e_d_i_t_o_r will be launched by EEDDIITT. BUFFER format : ssiizzee example : 2048 The maximun ssiizzee of the buffer (a unit is Kbytes) which will be allocated for a regular-file. CODE format : ccooddee00 ccooddee11 ... example : 1 8 ... If a regular-file that has no above ssuuffffiixxeess contains a control character under 0x20 excluding the ones set in here, it will be assumed as a binary file. _T_c_b(1) will execute _f_i_l_e(1) and display the code and the file-type. (If ccooddee00 is set to 0, this setting will be ignored.) SHELL format : _s_h_e_l_l example : tcsh It will specify SSHHEELLLL as either _b_a_s_h(1) or _t_c_s_h(1). You can't execute _t_c_b(1) unless you define this setting when neither _b_a_s_h(1) nor _t_c_s_h(1) is set in the environment variable ``SHELL''. HISTORY format : lliinnee example : 500 It determines the maximum lliinnee that will be saved to the HHIISSTTOORRYY list. When the value of mmooddee--lliinnee [[22]] (current-line / total- lines) are equal to this line, the oldest line will be deleted. WAIT format : wwaaiitt example : 10 Built-in or keyboard macro will be executed at intervals of wwaaiitt (a unit is 10 msec). SCROLL format : ffllaagg example : 1 The ffllaagg for switching scroll-mode. (can be switched by ^^OOhh.) When the flag is set, _t_c_b window will scroll excluding the bottom line. LS format : ffllaagg example : 1 The ffllaagg for switching display-mode of ffiillee--sseelleeccttoorr. (can be switched by ^^OOll.) When the flag is set, ffiillee--sseelleeccttoorr window will be displayed without extra space-character. If you want to display more faster in the directory that contains many files, reset the flag. KEY It will customize keys described in the KKEEYY. 55.. NNoottee Environment When you start _t_c_b(1) for the first time as a ffiillee mmaannaaggeerr, it will make working directory _~_/_._t_c_b_/ and _/_t_m_p_/_._t_c_b_/ (defined in _c_o_n_f_i_g_._s_h). If the same user tries to execute more than one ffiillee mmaannaaggeerr with no argument, _t_c_b(1) will exit with the message "AAllrreeaaddyy rruunnnniinngg". ``TCB'' environment variable will be utilized by _t_c_b(1) to determine whether the current terminal is SSHHEELLLL or not. _T_c_b(1) can't be started as a ffiillee mmaannaaggeerr on the terminals where this variable is set. When ``TCBCHARSET'' environment variable is set to aasscciiii, _t_c_b(1) will be started with aasscciiii-mode. This mode (can be switched by ^^OOaa) will display one-byte non-aasscciiii code as a highlighted hex number in angle brakets. When _t_c_b(1) is used as a ppaaggeerr, the output from the program such as _d_v_i_2_t_t_y(1) or _m_a_n(1) etc. can be displayed once you type `export PAGER=tcb EEnntteerr' on a terminal. However, this ``PAGER'' environment variable mustn't be changed at SSHHEELLLL. Mode stack Before entering a new mode, _t_c_b(1) will add the current mode on to the stack. (^^GG will return to the top of the stack.) These stack entries will be cleared when you select a directory in the ffiillee--sseelleeccttoorr or typing ^^JJ11 etc., and _t_c_b(1) will display the message "ttccbb vv11..44aa" at the mmooddee--lliinnee [[66]] (previous-mode). At the bottom of the stack, _t_c_b(1) will bring back the previous directory by typing ^^GG. Before saving the stack content to _~_/_._t_c_b_/_h_i_s_t_o_r_y at EEXXIITT, _t_c_b(1) will also release the stack entries until the mmooddee--lliinnee [[11]] (access-name) becomes a regular- file or a directory or a manual page. When you resize the window on _x_t_e_r_m(1) etc., the content of stack will not be renewed. Therefore, line continuation will not be displayed correctly in the window displayed by ^^GG. If you select a directory at DDUU, _t_c_b(1) will display the ffiillee-- sseelleeccttoorr window. If you then select a directory, the above stack entries will be cleared. In this case, ^^JJ^^DD will bring back the DDUU window. 66.. KKeeyy ffuunnccttiioonn The keys described in this section are preset in the program. 66..11.. WWiinnddooww PPaaggeeDDoowwnn : Move window one page down PPaaggeeUUpp : Move window one page up RRiigghhtt--aarrrrooww : Move window one line down LLeefftt--aarrrrooww : Move window one line up DDoowwnn--aarrrrooww : Move Cursor one line down UUpp--aarrrrooww : Move Cursor one line up ^^ZZ : Suspend ^^[[^^[[ : Exit 66..22.. CCoommmmaanndd--lliinnee BBaacckk ssppaaccee : Delete the character just before the cursor ^^HH : Delete the character just before the cursor ^^KK : Kill from the cursor to the end of line ^^UU : Kill from the cursor to the beginning of line ^^YY : Reinsert the last stretch of killed text ^^DD : Delete the character of cursor position ^^EE : Move to the end of line ^^AA : Move to the beginning of line ^^BB : Move backward a character ^^FF : Move forward a character ^^LL : Redisplay the window ^^NN : Move Cursor one line down ^^PP : Move Cursor one line up ^^MM : EEnntteerr ^^QQ : Input control character ^^GG : Return to the previous mode ^^SS : FFGGRREEPP ^^RR : HHIISSTTOORRYY ^^CC (SSHHEELLLL) : Interrupt ^^WW (SSHHEELLLL) : Redisplay the command ^^JJ^^WW or ^^JJww ^^WW (CCPP/MMVV/AARRCC) : Display previous directory name ^^II : Complete filename TTaabb : Complete filename PPaaggeeDDoowwnn : Move window one page down PPaaggeeUUpp : Move window one page up ^^VV : Move window one page down ^^[[vv : Move window one page up RRiigghhtt--aarrrrooww : Move window one line down LLeefftt--aarrrrooww : Move window one line up DDoowwnn--aarrrrooww : Move Cursor one line down UUpp--aarrrrooww : Move Cursor one line up ^^ZZ : Suspend 66..33.. IInntteerraaccttiioonn ^^\\ : Move window one page down ^^^^ : Move window one page up ^^CC : Interrupt input ^^DD : Terminate input ^^GG : Escape SSHHEELLLL ^^HH : Back space ^^MM : EEnntteerr ^^ZZ : Suspend