home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #27 / NN_1992_27.iso / spool / vmsnet / tpu / 499 next >
Encoding:
Text File  |  1992-11-16  |  8.0 KB  |  173 lines
  1. Newsgroups: vmsnet.tpu
  2. Path: sparky!uunet!decwrl!pa.dec.com!nntpd2.cxo.dec.com!nntpd.lkg.dec.com!evetpu.enet.dec.com!mccarthy
  3. From: mccarthy@evetpu.enet.dec.com (Brian J. McCarthy)
  4. Subject: Re: Undocumented MARK parameters.
  5. Message-ID: <1992Nov16.122517.19987@nntpd.lkg.dec.com>
  6. Sender: usenet@nntpd.lkg.dec.com (USENET News System)
  7. Organization: Digital Equipment Corporation
  8. References:   <1992Nov14.180146.1@slacvx.slac.stanford.edu>
  9. Date: Mon, 16 Nov 1992 12:12:36 GMT
  10. Lines: 161
  11.  
  12.  
  13. In article <1992Nov14.180146.1@slacvx.slac.stanford.edu>, fairfield@slacvx.slac.stanford.edu writes...
  14. >                     
  15. >        So, to the TPU gurus out there: Will these new parameters be
  16. >    documented and supported in subsequent releases?  What ARE the allowed
  17. >    parameter types for the 2nd and 3rd arguments?  What OTHER undocumented
  18. >    goodies are you hiding from us ?? :-)  There ARE others.  For example, I
  19. >    found, I found,
  20.  
  21. Here is the V3.1 version of the on-line help for TPU's SET (MARK) built-in
  22. procedure:
  23.  
  24.   MARK
  25.  
  26.       Returns a marker located in the specifed buffer, column, and record.
  27.       By default, the marker returned is located on the character in the
  28.       current buffer to which the editing point is tied.  The MARK built-in
  29.       also sets the video attribute for displaying the character on which the
  30.       marker is located (if any) when that character is visible on the
  31.       screen.
  32.  
  33.    Syntax
  34.  
  35.       marker := MARK ({NONE | BLINK | BOLD | REVERSE | UNDERLINE
  36.                       | FREE_CURSOR} [, {buffer | window} [, integer1
  37.                       [, integer2]]])
  38.  
  39.    Parameters
  40.  
  41.       NONE            Applies no video attributes to the marker.
  42.  
  43.       BLINK           Causes the marker to blink.
  44.  
  45.       BOLD            Causes the marker to be bolded.
  46.  
  47.       REVERSE         Causes the marker to be displayed in reverse video.
  48.  
  49.       UNDERLINE       Causes the marker to be underlined.
  50.  
  51.       FREE_CURSOR     Creates a free marker if you use the statement MARK
  52.                       (FREE_CURSOR) while the cursor is at a location
  53.                       containing no character, such as a location beyond the
  54.                       end of a line.  A free marker has no video attribute.
  55.                       DECTPU does not insert padding blanks between a free
  56.                       marker and the nearest character.  If you use the
  57.                       statement MARK (FREE_CURSOR) while the cursor is on a
  58.                       character, the resulting marker is tied to the
  59.                       character and is not free.
  60.  
  61.       buffer          The buffer in which the marker is to be located.  By
  62.                       default, DECTPU locates markers in the current buffer.
  63.  
  64.       window          The window that is mapped to the buffer in which the
  65.                       marker is to be located.  You can specify a window
  66.                       variable only if the window is mapped to a buffer.  By
  67.                       default, DECTPU locates markers in the current buffer.
  68.  
  69.       integer1        The screen column corresponding to the buffer offset
  70.                       where the marker is to be located.  This integer
  71.                       specifies the marker's location in the horizontal
  72.                       dimension.  You can specify any integer greater than or
  73.                       equal to 1 without causing an error.  However, the
  74.                       maximum record length in DECTPU is 32,767 characters.
  75.                       If you specify an integer greater than 32,767, the
  76.                       record is truncated after the 32,767th character.  If
  77.                       you specify an integer smaller than the record's left
  78.                       margin or greater than the end of the line, DECTPU
  79.                       places the marker in the specified location and inserts
  80.                       padding blanks in the buffer between the marker and the
  81.                       nearest text.  By default, DECTPU locates the marker in
  82.                       the buffer offset corresponding to the current screen
  83.                       column.  Note that DECTPU performs the conversion from
  84.                       screen column to buffer offset for you; you merely
  85.                       specify the desired screen column.  Note, too, that in
  86.                       cases where a window has been shifted, you still
  87.                       specify the column in relation to screen column 1 (the
  88.                       leftmost column on the screen), not in relation to the
  89.                       leftmost visible screen column.
  90.  
  91.       integer2        The number of the record in the buffer where the mark
  92.                       is to be located.  This integer specifies the marker's
  93.                       location in the vertical dimension.  If no limit has
  94.                       been set on the maximum number of lines in the buffer,
  95.                       this parameter can have any integer value greater than
  96.                       or equal to 1.  If a limit has been set for the maximum
  97.                       number of records in the buffer, the value of this
  98.                       parameter must be less than or equal to the limit.  By
  99.                       default, DECTPU places the marker in the current
  100.                       record.
  101.  
  102.    Comments
  103.  
  104.       If you create a marker in a location containing no character and
  105.       specify a parameter other than FREE_CURSOR, DECTPU inserts padding
  106.       blanks between the marker and the nearest character.  In such a
  107.       situation, the marker is bound.  If you fill text containing these
  108.       padding blanks, the white space created by the blanks is preserved in
  109.       the filled text.
  110.  
  111.       If you use the optional parameters to specify a location that has no
  112.       text associated with it, DECTPU places padding blanks in the space
  113.       between the new marker and the nearest character.
  114.  
  115.       If you create a marker in a location containing no character and
  116.       specify the parameter FREE_CURSOR, DECTPU does not insert padding
  117.       blanks.  If you fill text surrounding this marker, no white space is
  118.       created in the filled text.
  119.  
  120.       Once a marker is tied to a character, it cannot become a free marker.
  121.       To determine whether a marker is bound or free, use the following call:
  122.  
  123.       boolean_variable := GET_INFO (marker_variable, "bound");
  124.  
  125.       To determine the number of character positions between a free marker
  126.       and the nearest character, use the following call:
  127.  
  128.       boolean_variable := GET_INFO (marker_variable, "glyph_offset");
  129.  
  130.       To determine why a marker is free rather than bound, use one or more of
  131.       the following calls:
  132.  
  133.       boolean_variable := GET_INFO (marker_variable, "before_bol");
  134.       boolean_variable := GET_INFO (marker_variable, "beyond_eol");
  135.       boolean_variable := GET_INFO (marker_variable, "middle_of_tab");
  136.       boolean_variable := GET_INFO (marker_variable, "beyond_eob");
  137.  
  138.    Examples
  139.  
  140.  
  141.       1.  user_mark_under := MARK (UNDERLINE);
  142.  
  143.           Puts a marker at the row and column position corresponding to the
  144.           active editing point.  On the screen, the character at that marker
  145.           is underlined.
  146.  
  147.       2.  remote_marker := MARK (FREE_CURSOR, CURRENT_BUFFER, 1, 50);
  148.  
  149.           Puts a free marker in the current buffer in the leftmost character
  150.           offset on the 50th record.
  151.  
  152.    Related topics
  153.  
  154.       POSITION    SELECT    CREATE_RANGE    FILL
  155.  
  156. ******************************* End of Help Text *******************************
  157. You may wish to check the on-line help, it may be more up to date than your
  158. hard-copy documentation.
  159.  
  160. As for:
  161. >                if get_info (SCREEN, "vaxstation")
  162. > 
  163. >    in EVE$TERMINALS.TPU, but I can't figure out what sets the "vaxstation"
  164. >    bit and this "vaxstation" parameter is also not documented...
  165. > 
  166.  
  167. I belive this is left over from when the first windowing version of the product
  168. was being developed.  It will ALWAYS return a 0.  The new code is 
  169. get_info (screen, "decwindows") or get_info (screen, "motif")
  170.  
  171. Brian J. McCarthy - DECTPU/EVE Engineering Project Leader
  172. --------------------------------------------------------------------------------
  173.