>  Docs Center  >  Libraries  >  Galloy  >  man_print
Libraries

man_print

man.pro (mglib)

Prints basic information about a routine.

This is similar to the IDL library routine DOC_LIBRARY, but has several advantages:

1. DOC_LIBRARY is file-based whereas MAN is routine based. 2. MAN can provide the header information for a routine even if it has no header comments. 3. MAN can provide help for routines in DLMs.

Examples


Try the main-level example at the end of this file:

IDL> .run man
This does the following:
IDL> man, 'congrid' Filename: /Applications/itt/idl71/lib/congrid.pro result = congrid(arr, x, y, z, CENTER=CENTER, CUBIC=CUBIC, INTERP=INTERP, MINUS_ONE=MINUS_ONE) IDL> man, 'mg_*range*' Filename: /Users/mgalloy/projects/idllib/trunk/src/indices/mg_makerange.pro result = MG_MAKERANGE(startvalue, stopvalue, INCREMENT=INCREMENT, N=N) Filename: /Users/mgalloy/projects/idllib/trunk/src/analysis/mg_range.pro result = MG_RANGE(var)

Other file information


Uses:

mg_termcolumns,

Routines


man_printdocs, filename, routinename [, /is_function] [, output=strarr]

Print header docs for a routine in a given file.

man_resolveroutine, routine [, /resolved] [, _extra=keywords]

Routine to resolve a given routine without crashing.

result = man_width()

Wrapper for MG_TERMCOLUMNS in case it is not available.

man_print, text [, indent=string] [, output=strarr]

Print a string by splitting it across lines on spaces and indents every line except the first using the value of the INDENT keyword.

result = man_checkroutine(list, routine)

Checks to see if routine is in list.

man_routineinfo, routine [, output=strarr]

Print comments about a routine.

result = man_termavailable()

Determines if a term capable of paging is available:

man, routine [, /no_page]

Print comments about a routine or finds matching routines.

Routine details


man_printdocs


Print header docs for a routine in a given file.

Syntax


man_printdocs, filename, routinename [, /is_function] [, output=strarr]

Parameters


filename in required type=string

filename of the .pro file

routinename in required type=string

name of the routine to check docs for

Keywords


is_function in optional type=boolean

set to specify that the given routine is a function

output in out optional type=strarr

accumulation of output

man_resolveroutine


Routine to resolve a given routine without crashing.

Syntax


man_resolveroutine, routine [, /resolved] [, _extra=keywords]

Parameters


routine in required type=string

name of routine to resolve

Keywords


resolved out optional type=boolean

set to a named variable to find out if the routine was resolved

_extra in optional type=keywords

keywords to RESOLVE_ROUTINE

man_width


Wrapper for MG_TERMCOLUMNS in case it is not available.

The default is 80, if MG_TERMCOLUMNS is not found.

Syntax


result = man_width()

Return value


long

man_print


Print a string by splitting it across lines on spaces and indents every line except the first using the value of the INDENT keyword.

Syntax


man_print, text [, indent=string] [, output=strarr]

Parameters


text in required type=string

line to print

Keywords


indent in optional type=string

string to prefix each line except the first

output in out optional type=strarr

accumulation of output

man_checkroutine


Checks to see if routine is in list.

Syntax


result = man_checkroutine(list, routine)

Return value


1 if routine in in list; 0 if not

Parameters


list in required type=strarr

list of routines to check against

routine in required type=string

name of routine to check (case-insensitive)

man_routineinfo


Print comments about a routine.

Syntax


man_routineinfo, routine [, output=strarr]

Parameters


routine in required type=string

routine name to look up

Keywords


output in out optional type=strarr

accumulation of output

man_termavailable


Determines if a term capable of paging is available:

Syntax


result = man_termavailable()

Return value


1B if term available, 0B if not

man


Print comments about a routine or finds matching routines.

Syntax


man, routine [, /no_page]

Parameters


routine in required type=string

routine name to look up

Keywords


no_page in optional type=boolean

set to not page the output



© 2024 NV5 Geospatial Solutions, Inc. |  Legal
   Contact Us