Commit 9bb0da6100

Loris Cro <kappaloris@gmail.com>
2020-12-23 17:27:00
added comments, removed useless comptime keywords
1 parent 8c00c74
Changed files (1)
lib
std
os
lib/std/os/bits/darwin.zig
@@ -1576,37 +1576,37 @@ pub const VTIME = 17;
 pub const VSTATUS = 18;
 pub const NCCS = 20; // 2 spares (7, 19)
 
-pub const IGNBRK = 0x00000001;
-pub const BRKINT = 0x00000002;
-pub const IGNPAR = 0x00000004;
-pub const PARMRK = 0x00000008;
-pub const INPCK = 0x00000010;
-pub const ISTRIP = 0x00000020;
-pub const INLCR = 0x00000040;
-pub const IGNCR = 0x00000080;
-pub const ICRNL = 0x00000100;
-pub const IXON = 0x00000200;
-pub const IXOFF = 0x00000400;
-pub const IXANY = 0x00000800;
-pub const IMAXBEL = 0x00002000;
-pub const IUTF8 = 0x00004000;
-
-pub const OPOST = 0x00000001;
-pub const ONLCR = 0x00000002;
-pub const OXTABS = 0x00000004;
-pub const ONOEOT = 0x00000008;
-
-pub const OCRNL = 0x00000010;
-pub const ONOCR = 0x00000020;
-pub const ONLRET = 0x00000040;
-pub const OFILL = 0x00000080;
-pub const NLDLY = 0x00000300;
-pub const TABDLY = 0x00000c04;
-pub const CRDLY = 0x00003000;
-pub const FFDLY = 0x00004000;
-pub const BSDLY = 0x00008000;
-pub const VTDLY = 0x00010000;
-pub const OFDEL = 0x00020000;
+pub const IGNBRK = 0x00000001; // ignore BREAK condition
+pub const BRKINT = 0x00000002; // map BREAK to SIGINTR
+pub const IGNPAR = 0x00000004; // ignore (discard) parity errors
+pub const PARMRK = 0x00000008; // mark parity and framing errors
+pub const INPCK = 0x00000010; // enable checking of parity errors
+pub const ISTRIP = 0x00000020; // strip 8th bit off chars
+pub const INLCR = 0x00000040; // map NL into CR
+pub const IGNCR = 0x00000080; // ignore CR
+pub const ICRNL = 0x00000100; // map CR to NL (ala CRMOD)
+pub const IXON = 0x00000200; // enable output flow control
+pub const IXOFF = 0x00000400; // enable input flow control
+pub const IXANY = 0x00000800; // any char will restart after stop
+pub const IMAXBEL = 0x00002000; // ring bell on input queue full
+pub const IUTF8 = 0x00004000; // maintain state for UTF-8 VERASE
+
+pub const OPOST = 0x00000001; //enable following output processing
+pub const ONLCR = 0x00000002; // map NL to CR-NL (ala CRMOD)
+pub const OXTABS = 0x00000004; // expand tabs to spaces
+pub const ONOEOT = 0x00000008; // discard EOT's (^D) on output)
+
+pub const OCRNL = 0x00000010; // map CR to NL on output
+pub const ONOCR = 0x00000020; // no CR output at column 0
+pub const ONLRET = 0x00000040; // NL performs CR function
+pub const OFILL = 0x00000080; // use fill characters for delay
+pub const NLDLY = 0x00000300; // \n delay
+pub const TABDLY = 0x00000c04; // horizontal tab delay
+pub const CRDLY = 0x00003000; // \r delay
+pub const FFDLY = 0x00004000; // form feed delay
+pub const BSDLY = 0x00008000; // \b delay
+pub const VTDLY = 0x00010000; // vertical tab delay
+pub const OFDEL = 0x00020000; // fill is DEL, else NUL
 
 pub const NL0 = 0x00000000;
 pub const NL1 = 0x00000100;
@@ -1627,48 +1627,48 @@ pub const BS1 = 0x00008000;
 pub const VT0 = 0x00000000;
 pub const VT1 = 0x00010000;
 
-pub const CIGNORE = 0x00000001;
-pub const CSIZE = 0x00000300;
-pub const CS5 = 0x00000000;
-pub const CS6 = 0x00000100;
-pub const CS7 = 0x00000200;
-pub const CS8 = 0x00000300;
-pub const CSTOPB = 0x00000400;
-pub const CREAD = 0x00000800;
-pub const PARENB = 0x00001000;
-pub const PARODD = 0x00002000;
-pub const HUPCL = 0x00004000;
-pub const CLOCAL = 0x00008000;
-pub const CCTS_OFLOW = 0x00010000;
+pub const CIGNORE = 0x00000001; // ignore control flags
+pub const CSIZE = 0x00000300; // character size mask
+pub const CS5 = 0x00000000; //    5 bits (pseudo)
+pub const CS6 = 0x00000100; //    6 bits
+pub const CS7 = 0x00000200; //    7 bits
+pub const CS8 = 0x00000300; //    8 bits
+pub const CSTOPB = 0x0000040; // send 2 stop bits
+pub const CREAD = 0x00000800; // enable receiver
+pub const PARENB = 0x00001000; // parity enable
+pub const PARODD = 0x00002000; // odd parity, else even
+pub const HUPCL = 0x00004000; // hang up on last close
+pub const CLOCAL = 0x00008000; // ignore modem status lines
+pub const CCTS_OFLOW = 0x00010000; // CTS flow control of output
 pub const CRTSCTS = (CCTS_OFLOW | CRTS_IFLOW);
-pub const CRTS_IFLOW = 0x00020000;
-pub const CDTR_IFLOW = 0x00040000;
-pub const CDSR_OFLOW = 0x00080000;
-pub const CCAR_OFLOW = 0x00100000;
-pub const MDMBUF = 0x00100000;
-
-pub const ECHOKE = 0x00000001;
-pub const ECHOE = 0x00000002;
-pub const ECHOK = 0x00000004;
-pub const ECHO = 0x00000008;
-pub const ECHONL = 0x00000010;
-pub const ECHOPRT = 0x00000020;
-pub const ECHOCTL = 0x00000040;
-pub const ISIG = 0x00000080;
-pub const ICANON = 0x00000100;
-pub const ALTWERASE = 0x00000200;
-pub const IEXTEN = 0x00000400;
-pub const EXTPROC = 0x00000800;
-pub const TOSTOP = 0x00400000;
-pub const FLUSHO = 0x00800000;
-pub const NOKERNINFO = 0x02000000;
-pub const PENDIN = 0x20000000;
-pub const NOFLSH = 0x80000000;
-
-pub const TCSANOW = 0;
-pub const TCSADRAIN = 1;
-pub const TCSAFLUSH = 2;
-pub const TCSASOFT = 0x10;
+pub const CRTS_IFLOW = 0x00020000; // RTS flow control of input
+pub const CDTR_IFLOW = 0x00040000; // DTR flow control of input
+pub const CDSR_OFLOW = 0x00080000; // DSR flow control of output
+pub const CCAR_OFLOW = 0x00100000; // DCD flow control of output
+pub const MDMBUF = 0x00100000; // old name for CCAR_OFLOW
+
+pub const ECHOKE = 0x00000001; // visual erase for line kill
+pub const ECHOE = 0x00000002; // visually erase chars
+pub const ECHOK = 0x00000004; // echo NL after line kill
+pub const ECHO = 0x00000008; // enable echoing
+pub const ECHONL = 0x00000010; // echo NL even if ECHO is off
+pub const ECHOPRT = 0x00000020; // visual erase mode for hardcopy
+pub const ECHOCTL = 0x00000040; // echo control chars as ^(Char)
+pub const ISIG = 0x00000080; // enable signals INTR, QUIT, [D]SUSP
+pub const ICANON = 0x00000100; // canonicalize input lines
+pub const ALTWERASE = 0x00000200; // use alternate WERASE algorithm
+pub const IEXTEN = 0x00000400; // enable DISCARD and LNEXT
+pub const EXTPROC = 0x00000800; // external processing
+pub const TOSTOP = 0x00400000; // stop background jobs from output
+pub const FLUSHO = 0x00800000; // output being flushed (state)
+pub const NOKERNINFO = 0x02000000; // no kernel output from VSTATUS
+pub const PENDIN = 0x20000000; // XXX retype pending input (state)
+pub const NOFLSH = 0x80000000; // don't flush after interrupt
+
+pub const TCSANOW = 0; // make change immediate
+pub const TCSADRAIN = 1; // drain output, then change
+pub const TCSAFLUSH = 2; // drain output, flush input
+pub const TCSASOFT = 0x10; // flag - don't alter h.w. state
 pub const TCSA = extern enum(c_uint) {
     NOW,
     DRAIN,
@@ -1715,13 +1715,13 @@ pub const speed_t = u64;
 pub const tcflag_t = u64;
 
 pub const termios = extern struct {
-    iflag: tcflag_t,
-    oflag: tcflag_t,
-    cflag: tcflag_t,
-    lflag: tcflag_t,
-    cc: [NCCS]cc_t,
-    ispeed: speed_t align(8),
-    ospeed: speed_t,
+    iflag: tcflag_t, // input flags
+    oflag: tcflag_t, // output flags
+    cflag: tcflag_t, // control flags
+    lflag: tcflag_t, // local flags
+    cc: [NCCS]cc_t, // control chars
+    ispeed: speed_t align(8), // input speed
+    ospeed: speed_t, // output speed
 };
 
 pub const winsize = extern struct {
@@ -1731,9 +1731,9 @@ pub const winsize = extern struct {
     ws_ypixel: u16,
 };
 
-pub const TIOCGWINSZ = comptime ior(0x40000000, 't', 104, @sizeOf(winsize));
+pub const TIOCGWINSZ = ior(0x40000000, 't', 104, @sizeOf(winsize));
 pub const IOCPARM_MASK = 0x1fff;
 
-fn ior(comptime inout: u32, comptime group: usize, comptime num: usize, comptime len: usize) usize {
+fn ior(inout: u32, group: usize, num: usize, len: usize) usize {
     return (inout | ((len & IOCPARM_MASK) << 16) | ((group) << 8) | (num));
 }