Options


The operations CScout provides group together functions that globally affect its operation. The global options link leads you to the following page.

Global Options

Remove common path prefix in file lists
Sort identifiers starting from their last character
Show only true identifier classes (brief view)
Show line numbers in source listings
Case-insensitive file name regular expression match

Code listing tab width

Main page


CScout 1.6 - 2003/06/04 15:14:51
The meaning of each option is described in the following sections.

Remove Common Path Prefix in File Lists

Setting the ``remove common path prefix in file lists'' option will result in file lists grouped by the common path prefix as in the following example:
This results in lists that are easier to read, but that can not be easilly copy-pasted into other tools for further processing.

Sort Identifiers Starting from their Last character

Some coding conventions use identifier suffixes for distinguishing the use of a given identifier. As an example, typedef identifiers often end in _t. The following list contains our example's typedefs ordered by the last character, making it easy to distinguish typedefs not ending in _t
FILE
FTS
FTSENT
PATH_T
_RuneRange
_RuneLocale
u_long
fd_mask
u_char
physadr
int32_t
__int32_t
u_int32_t
uint32_t
__uint32_t
inthand2_t
ointhand2_t
int64_t
[... 40 lines removed]
in_addr_t
caddr_t
c_caddr_t
v_caddr_t
daddr_t
ufs_daddr_t
u_daddr_t
qaddr_t
__sighandler_t
__siginfohandler_t
timer_t
register_t
u_register_t
intptr_t
__intptr_t
uintptr_t
__uintptr_t
fpos_t
timecounter_pps_t
timecounter_get_t
vm_offset_t
vm_ooffset_t
sigset_t
osigset_t
fixpt_t
in_port_t
mcontext_t
ucontext_t
dev_t
div_t
ldiv_t
vm_pindex_t
key_t
segsz_t
fd_set
u_int
uint
u_short
ushort
_RuneEntry

Show Only True Identifier Classes

Setting the option ``show only true identifier classes (brief view)'' will remove from each identifier page all identifier properties marked as no, resulting in a less verbose page.

Identifier: argc

  • Ordinary identifier: Yes
  • Matches 8 occurence(s)
  • Appears in project(s):
    • cp
  • Substitute with:

Dependent Files (Writable)

Dependent Files (All)

Main page


CScout 1.6 - 2003/06/04 15:14:51

Show Line Numbers in Source Listings

The "show line numbers in source listings" option allows you to specify whether the source file line numbers will be shown in source listings. Line numbers can be useful when you are editing or viewing the same file with an editor. A file with line numbers shown appears as follows:

   78 fa *makedfa(const char *s, int anchor)  /* returns dfa for reg expr s */
   79 {
   80         int i, use, nuse;
   81         fa *pfa;
   82         static int now = 1;
   83 
   84         if (setvec == 0) {      /* first time through any RE */
   85                 maxsetvec = MAXLIN;
   86                 setvec = (int *) malloc(maxsetvec * sizeof(int));
   87                 tmpset = (int *) malloc(maxsetvec * sizeof(int));
   88                 if (setvec == 0 || tmpset == 0)
   89                         overflo("out of space initializing makedfa");
   90         }
   91 
   92         if (compile_time)       /* a constant for sure */
   93                 return mkdfa(s, anchor);
   94         for (i = 0; i < nfatab; i++)    /* is it there already? */
   95                 if (fatab[i]->anchor == anchor
   96                   && strcmp((const char *) fatab[i]->restr, s) == 0) {
   97                         fatab[i]->use = now++;
   98                         return fatab[i];
   99                 }
  100         pfa = mkdfa(s, anchor);
  101         if (nfatab < NFA) {     /* room for another */
  102                 fatab[nfatab] = pfa;
  103                 fatab[nfatab]->use = now++;
  104                 nfatab++;
  105                 return pfa;
  106         }

Case-insensitive File Name Regular Expression Match

Some environments, such as Microsoft Windows, are matching filenames in a case insensitive manner. As a result the same filename may appear with different capitalization (e.g. Windows.h, WINDOWS.h, and windows.h). The use of the ``case-insensitive file name regular expression match'' option makes filename regular expression matches ignore letter case thereby matching the operating system's semantics.

Code Listing Tab Width

The ``code listing tab width'' option allows you to specify the tab width to use when listing source files as hypertext (8 by default). The width should match the width normally used to display the file. It does not affect the way the modified file is written; tabs and spaces will get written exactly as found in the source code file.

Contents Previous Next (Operations)


Last change: Saturday, August 16, 2003 6:52 pm
(C) Copyright 2000-2003 Diomidis Spinellis. May be freely viewed using web browsers and similar programs. All other rights reserved.