NAME

toggle_high_light - Toggles output high-lighting if argument is a terminal

SYNOPSIS

#include "l/l_sys_term.h"

Example compile flags (system dependent):
  -DLINUX_386 -DLINUX_386_P4  
   -I/home/kobus/include
   -L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
  -lKJB         -llapack -lblas -lg2c          -lXext -lX11 


int toggle_high_light(FILE *fp);

DESCRIPTION

If "fp" is the terminal, then the high-light setting is toggled, and the appropriate control sequence for high-lighting or normal text is output onto the terminal as appropriate. If "fp" is not a terminal, then nothing is done.

RETURNS

NO_ERROR on success and ERROR on failure. If "fp" is not a terminal, then NO_ERROR is returned, as a properly executed no-op is considered successfully.

SEEALSO

set_high_light, unset_high_light

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTOR

Kobus Barnard

SEE ALSO

kjb_use_default_paging , kjb_enable_paging , kjb_disable_paging , kjb_restore_paging , is_in_background , put_prompt , term_puts , term_put_n_chars , term_put_n_raw_chars , term_get_n_chars , move_cursor_up , term_beep , term_beep_beep , term_get_line , enhanced_term_getc , term_getc , set_high_light , unset_high_light , term_blank_out_line , term_set_no_blocking , term_set_blocking