Author: pebender
Date: Mon Feb 9 20:08:51 2009
New Revision: 4371
Modified:
trunk/gar-minimyth/html/minimyth/document-configure.html
Log:
- Added information about line breaks to the documentation.
Modified: trunk/gar-minimyth/html/minimyth/document-configure.html
==============================================================================
--- trunk/gar-minimyth/html/minimyth/document-configure.html (original)
+++ trunk/gar-minimyth/html/minimyth/document-configure.html Mon Feb 9
20:08:51 2009
@@ -30,6 +30,7 @@
<dt><a href="#bootline">Configuration obtained from the boot
line</a></dt>
<dt><a href="#dhcp">Configuration obtained from the DHCP
server</a></dt>
<dt><a href="#location">Location of configuration
files</a></dt>
+ <dt><a href="#format">Format of configuration files</a></dt>
<dt><a href="#minimyth_conf">Configuration obtained from the
MiniMyth configuration file</a></dt>
<dt><a href="#minimyth_pm">Configuration obtained from the
MiniMyth configuration package</a></dt>
<dt><a href="#misc">Configuration obtained from miscellaneous
configuration files</a></dt>
@@ -406,6 +407,36 @@
and '{file}' is the name of the configuration file.
</p>
</div>
+ <div id="format" class="section">
+ <div class="heading">Format of configuration files</div>
+ <p>
+ Many of MiniMyth's configuration files are ASCII text.
+ In some cases,
+ if the ASCII text configuration file uses the wrong
character(s) to represent a line break,
+ then the MiniMyth software using the configuration file will
fail to work correctly.
+ Unfortunately, different operating systems use different ASCII
characters to represent a line break:
+ Unix/Linux uses LF, Mac OS uses CR and DOS/Windows uses CRLF.
+ If you transfer, create or edit ASCII text files using an
operating system other than Unix/Linux,
+ then it is likely to use the wrong ASCII characater(s) to
represent a line break.
+ </p>
+ <p>
+ Whether or not a text editor running on Linux lets you know
+ that file contains non-Linux line breaks is editor dependent.
+ Therefore, a lack of visible strange characters at the end of
each line
+ does not mean that the file has only Linux line breaks.
+ Whether or not a text editor running on Linux converts
non-Linux line breaks to Linux line breaks is editor dependent.
+ Therefore, saving a file transfered, created or edited on a
different operating system
+ using a text editor running on Linux does not mean that the
file will have only Linux line breaks.
+ </p>
+ <p>
+ The best way to ensure that you do not run into this problem
is to transfer, create and edit
+ all ASCII text configuration files on Linux.
+ However, if you did transfer, create or edit an ASCII text
configuration file
+ on a computer running Mac OS or DOS/Windows,
+ then you can use the
+ <a
href="http://linuxcommand.org/man_pages/dos2unix1.html";>dos2unix</a>
+ command to ensure that the file contains only Linux line
breaks.
+ </p>
<div id="minimyth_conf" class="section">
<div class="heading">Configuration obtained from the MiniMyth
configuration file</div>
<p>
@@ -656,7 +687,7 @@
alt="Valid CSS!" height="31" width="88" /></a>
</div>
<div class="version">
- Last Updated on 2009-01-28
+ Last Updated on 2009-02-09
<br />
< mailto : webmaster at minimyth dot org >
</div>
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"minimyth-commits" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/minimyth-commits?hl=en
-~----------~----~----~----~------~----~------~--~---
