From 53dda1a9cfc453fa5b2e5ff0ed58f8a9c99749a9 Mon Sep 17 00:00:00 2001
From: Rob Landley <rob@landley.net>
Date: Sun, 25 Jan 2009 16:59:14 -0600
Subject: Comment tweaks.
---
toys.h | 13 +++++++++----
1 file changed, 9 insertions(+), 4 deletions(-)
diff --git a/toys.h b/toys.h
index 1896361f..2920cca4 100644
--- a/toys.h
+++ b/toys.h
@@ -54,16 +54,21 @@ struct toy_list *toy_find(char *name);
void toy_init(struct toy_list *which, char *argv[]);
void toy_exec(char *argv[]);
-// List of available applets
+// Flags describing applet behavior.
#define TOYFLAG_USR (1<<0)
#define TOYFLAG_BIN (1<<1)
#define TOYFLAG_SBIN (1<<2)
#define TOYMASK_LOCATION ((1<<4)-1)
+// This is a shell built-in function, running in the same process context.
#define TOYFLAG_NOFORK (1<<4)
+
+// Start applet with a umask of 0 (saves old umask in this.old_umask)
#define TOYFLAG_UMASK (1<<5)
+// Array of available applets
+
extern struct toy_list {
char *name;
void (*toy_main)(void);
@@ -71,7 +76,7 @@ extern struct toy_list {
int flags;
} toy_list[];
-// Global context for any applet.
+// Global context shared by all applets.
extern struct toy_context {
struct toy_list *which; // Which entry in toy_list is this one?
@@ -80,8 +85,8 @@ extern struct toy_context {
unsigned optflags; // Command line option flags from get_optflags()
char **optargs; // Arguments left over from get_optflags()
int optc; // Count of optargs
- int exithelp; // Should error_exit print a usage message first? (Option parsing.)
- int old_umask;
+ int exithelp; // Should error_exit print a usage message first?
+ int old_umask; // Old umask preserved by TOYFLAG_UMASK
} toys;
// One big temporary buffer, for use by applets (not library functions).
--
cgit v1.2.3