home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume29 / parseargs / part01 / doc / parsemodes.inc < prev    next >
Encoding:
Text File  |  1992-05-19  |  1.4 KB  |  25 lines
  1. .\"----------------------------------------------------------------------------
  2. .\"-- This text was extracted using the following command:
  3. .\"--   xdoc -man -p '[ \t]*' -s PARSE-MODES ../parseargs.h
  4. .\"----------------------------------------------------------------------------
  5. .SH "PARSE MODES"
  6. .PP
  7. \fIParsecntl\fP may be used to read current command attributes, write
  8. (assign) new command attributes, or both. The mode argument to
  9. parsecntl determines which of these three alternatives are
  10. desired. If the programmer merely wishes to assign new attributes,
  11. then invoking \fIparsecntl\fP in \fIpc_\s-1WRITE\s+1\fP mode and passing
  12. the new attributes will do the job. If the programmer wishes simply to query
  13. attributes, then invoking \fIparsecntl\fP in \fIpc_\s-1READ\s+1\fP mode and
  14. passing a pointer to the desired object in which to write the attribute
  15. settings will suffice.
  16.  
  17. If the programmer wishes to assign new attributes and at the same time
  18. find out what the attributes were before making the assignment, then
  19. programmer must invoke \fIparsecntl\fP for \fIpc_\s-1RDWR\s+1\fP mode
  20. and pass a pointer to the object containing the new attribute settings;
  21. When \fIparsecntl\fP returns, then (assuming it returns 0) the desired
  22. attributes will have been assigned and the object that contained the
  23. new attribute settings will now contain the attribute settings that
  24. were in effect immediately before \fIparsecntl\fP was invoked.
  25.