X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fdefault_colors.3x.html;h=ae05ea39017b0f8f884ee425afb7dcdc6ffccff1;hp=d0be6fb6a2042323a0116e35503ba71eade4f471;hb=2e5d72d6396bb38a8d1d1b3534f62e28aebaa600;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01 diff --git a/doc/html/man/default_colors.3x.html b/doc/html/man/default_colors.3x.html index d0be6fb6..ae05ea39 100644 --- a/doc/html/man/default_colors.3x.html +++ b/doc/html/man/default_colors.3x.html @@ -1,7 +1,7 @@ - + @@ -41,6 +41,10 @@ 
 
+default_colors(3x)                                   default_colors(3x)
+
+
+

NAME

@@ -111,60 +115,61 @@
        These functions return the integer ERR upon failure and OK
        on success.  They will fail if either  the  terminal  does
        not  support  the orig_pair or orig_colors capability.  If
-       the initialize_pair capability is found,  this  causes  an
-       error as well.
+       the initialize_pair capability is not found,  this  causes
+       an error as well.

NOTES

-       Associated with this extension, the init_pair(3x) function
+       Associated  with  this  extension,  the init_pair function
        accepts negative arguments to specify  default  foreground
        or background colors.
 
+       The  use_default_colors()  function  was  added to support
+       ded.  This is a full-screen application which uses  curses
+       to  manage only part of the screen.  The bottom portion of
+       the screen, which is of adjustable size, is left uncolored
+       to  display the results from shell commands.  The top por-
+       tion of the screen colors filenames using  a  scheme  like
+       the  "color  ls" programs.  Attempting to manage the back-
+       ground color of the screen for this application would give
+       unsatisfactory  results  for  a  variety of reasons.  This
+       extension was devised after noting that color  xterm  (and
+       similar  programs)  provides a background color which does
+       not necessarily correspond to  any  of  the  ANSI  colors.
+       While  a special terminfo entry could be constructed using
+       nine colors, there was no mechanism provided within curses
+       to  account for the related orig_pair and back_color_erase
+       capabilities.
+
+       The assume_default_colors() function was added to solve  a
+       different  problem:  support  for applications which would
+       use  environment  variables  and  other  configuration  to
+       bypass  curses'  notion  of the terminal's default colors,
+       setting specific values.
+

PORTABILITY

-       These  routines  are  specific  to ncurses.  They were not
-       supported on Version 7, BSD or System  V  implementations.
-       It  is recommended that any code depending on them be con-
+       These routines are specific to  ncurses.   They  were  not
+       supported  on  Version 7, BSD or System V implementations.
+       It is recommended that any code depending on them be  con-
        ditioned using NCURSES_VERSION.

SEE ALSO

-       curs_color(3x), ded(1).
+       curs_color(3x), ded(1).

AUTHOR

-       Thomas Dickey (from an analysis of  the  requirements  for
+       Thomas  Dickey  (from  an analysis of the requirements for
        color xterm for XFree86 3.1.2C, February 1996).
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+                                                     default_colors(3x)