Return to muxstring.3 CVS log

Up to [Research Unix] / researchv9 / jtools / man / man3

Annotation of researchv9/jtools/man/man3/muxstring.3, revision 1.1.1.1

1.1       root        1: .TH MUXSTRING 3
                      2: .SH NAME
                      3: setmuxbuf, getmuxbuf \- exchanging strings between tools
                      4: .SH SYNOPSIS
                      5: .B #include <jerq.h>
                      6: .PP
                      7: .B setmuxbuf(s); String *s;
                      8: .PP
                      9: .B getmuxbuf(d); String *d;
                     10: .SH DESCRIPTION
                     11: These functions manipulate strings represented
                     12: in the following form.
                     13: .IP
                     14: .EX
                     15: .ta \w'struct 'u
                     16: struct String {
                     17:        char *s;
                     18:        short n;
                     19:        short size;
                     20: };
                     21: .EE
                     22: .LP
                     23: The string proper occupies the first 
                     24: .B n
                     25: characters of a data block of
                     26: .L size
                     27: characters pointed to by
                     28: .BR s .
                     29: Initially both
                     30: .B size
                     31: and
                     32: .B s
                     33: should be 0.
                     34: Strings are always counted, not terminated by
                     35: .BR \e0 .
                     36: The functions obtain space as needed from
                     37: .IR gcalloc  ;
                     38: see
                     39: .IR alloc (3).
                     40: .PP
                     41: .I Setmuxbuf
                     42: copies string 
                     43: .I s
                     44: into the snarf buffer maintained by
                     45: the underlying window system;
                     46: .I getmuxbuf
                     47: copies from the snarf buffer into
                     48: .I d.
                     49: .SH SEE ALSO
                     50: .IR string (3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.