Some admittedly trivial notes about the wiki page on "The UCI System":
http://wiki.openwrt.org/doc/uci that I will leave to others to process or ignore as they wish -- just observations on things that puzzled me briefly as I was reading that page. Being a long-time editor and proofreader, even little things tend to drive me a bit nuts. * Intro para claims that a daemon with a UCI-compatible init script will overwrite that package's original config file. Not always, though, right? As I read it, some packages will simply create an equivalent config file under /var/etc, and point the daemon at that one, no? So the original /etc config file is not always overwritten, do I have that right? * There are probably updates that can be done to that table of config files associated with packages. As one example, there's a reference to /etc/config/racoon, but that utility is part of ipsec-tools, and I don't see that config file for racoon. (The link for that takes one to a page that lists racoon configuration as being in "an advanced beta state".) * Under "File Syntax", an example config file is shown starting with a "package" line, but that line isn't required -- isn't it only added by the "uci" utility when creating the file? Not a big deal, but it leads the reader to believe that line is required, when *none* of the standard config files have such a line, so it's potentially confusing. * I mentioned this before, but at the end of that same section, there is what appears to be a fairly adamant claim that hyphens are not legal characters in UCI identifiers, but the file /etc/config/wireless contains the type name "wifi-iface", so it's not clear what the rules are. Also, is it true that upper-case characters are not allowed, since that what that pattern seems to be suggesting. The next few observations are all about the "Command Line Utility" section. The "Usage" section makes no mention of uci's "del_list" or "reorder" subcommands, and the "delete" subcommand entry seems incomplete as it doesn't mention the [[=<id>]] portion printed out by "uci help". Both the help output from "uci" and the subsequent table would seem to need updating. Some of the subsequent examples of usage seem out of date or irrelevant. For instance, the first one shows: uci set uhttpd.main.listen_http=8080 but that config value is a list these days, not a single value. The next example using "httpd" seems irrelevant since most people would be using uhttpd, not httpd -- might be worth replacing that with something more likely to be part of the base system that readers can actually run and examine. I think that's it for now. Onward ... rday _______________________________________________ openwrt-users mailing list [email protected] https://lists.openwrt.org/cgi-bin/mailman/listinfo/openwrt-users
