081fe506f3
This commit introduces an extremely powerful, flexible brand new capability. Now, users can pause the normal iterative display and inspect the contents of any file or output from any script, command, or even pipelines. It's invoked via the 'Y' interactive command which, in turn, is supported with simple user supplied additions as new entries in the top personal configuration file. A separate new 'Inspect' window supports scrolling and searching, similar to the main top display. Except it extends existing 'L'/'&' (locate/locate-next) commands so that an out-of-view match automatically adjusts the horizontal position bringing such data into view. And it provides for multiple successive same line matches. Also, the basic 'more/less' navigation keys are active in this new 'Inspect' window, to ease user transition. There are no program changes required when entries are added to or deleted from the rcfile. And there are no known limits to the complexity of a script, command or pipeline, other than the unidirectional nature imposed by the 'popen' function call which top cannot violate. Since it's impossible to predict exactly what contents will be generated, top treats all output as raw binary data. Any control characters display in '^C' notation while all other unprintable characters show as '<AB>'. The biggest problem encountered was with the find/next capability since that strstr guy was really diminished given the possibility that numerous 'strings' could be encountered *within* many of top's raw, binary 'rows'. Oh, and another problem was in maintaining the perfect left & right text justification of this commit message along with all of the commit summaries. Some of those summaries (like this very one) are of course, slightly shorter, to make room for the 'man document' addition. Enjoy! Signed-off-by: Jim Warner <james.warner@comcast.net>
108 lines
4.6 KiB
C
108 lines
4.6 KiB
C
/* top_nls.h - provide the basis for future nls translations */
|
||
/*
|
||
* Copyright (c) 2011-2012, by: James C. Warner
|
||
* All rights reserved. 8921 Hilloway Road
|
||
* Eden Prairie, Minnesota 55347 USA
|
||
*
|
||
* This file may be used subject to the terms and conditions of the
|
||
* GNU Library General Public License Version 2, or any later version
|
||
* at your option, as published by the Free Software Foundation.
|
||
* This program is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
* GNU Library General Public License for more details.
|
||
*/
|
||
/* For contributions to this program, the author wishes to thank:
|
||
* Craig Small, <csmall@small.dropbear.id.au>
|
||
* Sami Kerola, <kerolasa@iki.fi>
|
||
*/
|
||
#ifndef _Itop_nls
|
||
#define _Itop_nls
|
||
|
||
/*
|
||
* These are our string tables with the following contents:
|
||
* Head : column headings with varying size limits
|
||
* Desc : field descriptions not to exceed 20 screen positions
|
||
* Norm : regular text possibly also containing c-format specifiers
|
||
* Uniq : show_special specially formatted strings
|
||
*
|
||
* The latter table presents the greatest translation challenge !
|
||
*
|
||
* We go to the trouble of creating the nls string tables to achieve
|
||
* these objectives:
|
||
* + the overhead of repeated runtime calls to gettext()
|
||
* will be avoided
|
||
* + the order of the strings in the template (.pot) file
|
||
* can be completely controlled
|
||
* + none of the important translator only comments will
|
||
* clutter and obscure the main program
|
||
*/
|
||
extern const char *Head_nlstab[];
|
||
extern const char *Desc_nlstab[];
|
||
extern const char *Norm_nlstab[];
|
||
extern const char *Uniq_nlstab[];
|
||
|
||
/*
|
||
* Simple optional macros to ease table access.
|
||
* The N_txt and N_fmt macros are interchangeable but
|
||
* highlight the two types of strings found in Norm_nlstable.
|
||
*/
|
||
#define N_col(e) Head_nlstab[e]
|
||
#define N_fld(e) Desc_nlstab[e]
|
||
#define N_txt(e) Norm_nlstab[e]
|
||
#define N_fmt(e) Norm_nlstab[e]
|
||
#define N_unq(e) Uniq_nlstab[e]
|
||
|
||
/*
|
||
* These enums are the means to access two of our four tables.
|
||
* The Head_nlstab and Desc_nlstab are accessed with standard
|
||
* top pflag enums.
|
||
*
|
||
* The norm_nls enums carry a suffix distinguishing plain text
|
||
* from any text also containiing c-format specifiers.
|
||
*/
|
||
enum norm_nls {
|
||
AMT_kilobyte_txt, AMT_megabyte_txt, AMT_gigabyte_txt, BAD_delayint_fmt,
|
||
BAD_integers_txt, BAD_max_task_txt, BAD_mon_pids_fmt, BAD_niterate_fmt,
|
||
BAD_numfloat_txt, BAD_signalid_txt, BAD_username_txt, BAD_widtharg_fmt,
|
||
CHOOSE_group_txt, COLORS_nomap_txt, DELAY_badarg_txt, DELAY_change_fmt,
|
||
DELAY_secure_txt, DISABLED_cmd_txt, DISABLED_win_fmt, EXIT_signals_fmt,
|
||
FAIL_alloc_c_txt, FAIL_alloc_r_txt, FAIL_openlib_fmt, FAIL_rc_open_fmt,
|
||
FAIL_re_nice_fmt, FAIL_sigmask_fmt, FAIL_signals_fmt, FAIL_sigstop_fmt,
|
||
FAIL_statget_txt, FAIL_statopn_fmt, FAIL_tty_get_txt, FAIL_tty_mod_fmt,
|
||
FAIL_tty_raw_fmt, FAIL_widecpu_txt, FAIL_widepid_txt, FIND_no_find_fmt,
|
||
FIND_no_next_txt, FOREST_modes_fmt, FOREST_views_txt, GET_find_str_txt,
|
||
GET_max_task_fmt, GET_nice_num_fmt, GET_pid2kill_fmt, GET_pid2nice_fmt,
|
||
GET_sigs_num_fmt, GET_user_ids_txt, HELP_cmdline_fmt, HILIGHT_cant_txt,
|
||
IRIX_curmode_fmt, LIMIT_exceed_fmt, MISSING_args_fmt, NAME_windows_fmt,
|
||
NOT_onsecure_txt, NOT_smp_cpus_txt, OFF_one_word_txt, ON_word_only_txt,
|
||
RC_bad_entry_fmt, RC_bad_files_fmt, SCROLL_coord_fmt, SELECT_clash_txt,
|
||
THREADS_show_fmt, TIME_accumed_fmt, UNKNOWN_cmds_txt, UNKNOWN_opts_fmt,
|
||
USAGE_abbrev_txt, WORD_allcpus_txt, WORD_another_txt, WORD_eachcpu_fmt,
|
||
WORD_process_txt, WORD_threads_txt, WRITE_rcfile_fmt, WRONG_switch_fmt,
|
||
XTRA_fixwide_fmt,
|
||
#ifndef WARN_CFG_OFF
|
||
XTRA_warncfg_txt,
|
||
#endif
|
||
#ifndef INSP_OFFDEMO
|
||
YINSP_demo01_txt, YINSP_demo02_txt, YINSP_demo03_txt, YINSP_demo04_txt,
|
||
YINSP_demo05_txt,
|
||
#endif
|
||
YINSP_failed_fmt, YINSP_noents_txt, YINSP_pidbad_fmt, YINSP_pidsee_fmt,
|
||
YINSP_rcfile_fmt, YINSP_status_fmt, YINSP_workin_txt,
|
||
norm_MAX
|
||
};
|
||
|
||
enum uniq_nls {
|
||
KEYS_helpbas_fmt, KEYS_helpext_fmt, WINDOWS_help_fmt, COLOR_custom_fmt,
|
||
FIELD_header_fmt, MEMORY_lines_fmt, STATE_line_1_fmt, STATE_lin2x4_fmt,
|
||
STATE_lin2x5_fmt, STATE_lin2x6_fmt, STATE_lin2x7_fmt, INSP_hdrbase_fmt,
|
||
INSP_hdrsels_fmt, INSP_hdrview_fmt,
|
||
uniq_MAX
|
||
};
|
||
|
||
void initialize_nls (void);
|
||
|
||
#endif /* _Itop_nls */
|
||
|