Utils/Termlib: Add some logging

[senf.git] / Utils / Logger / FileTarget.cc

diff --git a/Utils/Logger/FileTarget.cc b/Utils/Logger/FileTarget.cc
index 52ebaf8..568cc9d 100644 (file)
--- a/Utils/Logger/FileTarget.cc
+++ b/Utils/Logger/FileTarget.cc
@@ -33,8 +33,21 @@
 #define prefix_
 ///////////////////////////////cc.p////////////////////////////////////////
 
+namespace {
+    
+    std::string quoteFilename(std::string filename)
+    {
+        for (std::string::iterator i (filename.begin()); i != filename.end(); ++i)
+            if (! senf::console::CommandParser::isWordChar(*i))
+                *i = '_';
+        return filename;
+    }
+
+}
+
 prefix_ senf::log::FileTarget::FileTarget(std::string const & file)
-    : ofstream_t(file.c_str(), std::ofstream::app), IOStreamTarget(file, ofstream_t::member), 
+    : ofstream_t(file.c_str(), std::ofstream::app), 
+      IOStreamTarget(quoteFilename(file), ofstream_t::member), 
       file_(file)
 {
     consoleDir().add( "reopen", senf::membind(
@@ -68,7 +81,19 @@ prefix_ senf::log::FileTarget::RegisterConsole::RegisterConsole()
 {
     detail::TargetRegistry::instance().consoleDir().add("file-target",&RegisterConsole::create)
         .arg("filename", "name of logfile")
-        .doc("Create new file target.");
+        .doc("Create new file target. Examples:\n"
+             "\n"
+             "Create new file target '/var/log/example.log\n"
+             "    $ file-target \"/var/log/example.log\"\n"
+             "    <Directory '/sys/log/_var_log_example.log'>\n"
+             "\n"
+             "In a configuration file, create new file target '/var/log/example.log' and set\n"
+             "some parameters (If written on one line, this works at the console too:\n"
+             "    /sys/log/file-target \"/var/log/example.log\" {\n"
+             "        route (IMPORTANT);             # route all important messages\n"
+             "        timeFormat \"\";               # use non-formatted time format\n"
+             "        showArea false;                # don't show log area\n"
+             "    }\n");
 }
 
 prefix_ boost::shared_ptr<senf::console::DirectoryNode>