xref: /dokuwiki/inc/init.php (revision 1983acc20576d136a43b0efc317dd07d1c048536)
1ed7b5f09Sandi<?php
2ed7b5f09Sandi/**
3ed7b5f09Sandi * Initialize some defaults needed for DokuWiki
4ed7b5f09Sandi */
5ed7b5f09Sandi
6a609a9ccSBen Coburn  // start timing Dokuwiki execution
7a609a9ccSBen Coburn  function delta_time($start=0) {
8a609a9ccSBen Coburn    list($usec, $sec) = explode(" ", microtime());
9a609a9ccSBen Coburn    return ((float)$usec+(float)$sec)-((float)$start);
10a609a9ccSBen Coburn  }
11a609a9ccSBen Coburn  define('DOKU_START_TIME', delta_time());
12a609a9ccSBen Coburn
13ed7b5f09Sandi  // define the include path
14ed7b5f09Sandi  if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../').'/');
15ad15db82Sandi
16e7cb32dcSAndreas Gohr  // define config path (packagers may want to change this to /etc/dokuwiki/)
17b7551a6dSEsther Brunner  if(!defined('DOKU_CONF')) define('DOKU_CONF',DOKU_INC.'conf/');
18e7cb32dcSAndreas Gohr
19bad905f1SBen Coburn  // check for error reporting override or set error reporting to sane values
20d8186216SBen Coburn  if (!defined('DOKU_E_LEVEL') && @file_exists(DOKU_CONF.'report_e_all')) {
21bad905f1SBen Coburn    define('DOKU_E_LEVEL', E_ALL);
22bad905f1SBen Coburn  }
23bad905f1SBen Coburn  if (!defined('DOKU_E_LEVEL')) { error_reporting(E_ALL ^ E_NOTICE); }
24bad905f1SBen Coburn  else { error_reporting(DOKU_E_LEVEL); }
25c53ea5f2Sandi
2650602150SBen Coburn  // init memory caches
27bc3e97beSAndreas Gohr  global $cache_revinfo;  $cache_revinfo = array();
28bc3e97beSAndreas Gohr  global $cache_wikifn;   $cache_wikifn = array();
29a424cd8eSchris  global $cache_cleanid;  $cache_cleanid = array();
30a424cd8eSchris  global $cache_authname; $cache_authname = array();
310a7e3bceSchris  global $cache_metadata; $cache_metadata = array();
3250602150SBen Coburn
334724a577Sandi  //prepare config array()
34ee20e7d1Sandi  global $conf;
3503c4aec3Schris  if (!defined('DOKU_UNITTEST')) {
364724a577Sandi    $conf = array();
374724a577Sandi
38ad15db82Sandi    // load the config file(s)
39e7cb32dcSAndreas Gohr    require_once(DOKU_CONF.'dokuwiki.php');
400a6ead41SAndreas Gohr    if(@file_exists(DOKU_CONF.'local.php')){
410a6ead41SAndreas Gohr      require_once(DOKU_CONF.'local.php');
420a6ead41SAndreas Gohr    }
4303c4aec3Schris  }
44ad15db82Sandi
45ad15db82Sandi  //prepare language array
46ee20e7d1Sandi  global $lang;
47ad15db82Sandi  $lang = array();
48ed7b5f09Sandi
4916521111Sandi  //load the language files
50bc3b6aecSandi  require_once(DOKU_INC.'inc/lang/en/lang.php');
51f949a01cSAndreas Gohr  if ( $conf['lang'] && $conf['lang'] != 'en' ) {
52bc3b6aecSandi    require_once(DOKU_INC.'inc/lang/'.$conf['lang'].'/lang.php');
53fc1c55b1Shfuecks  }
5416521111Sandi
55ed7b5f09Sandi  // define baseURL
56ed7b5f09Sandi  if(!defined('DOKU_BASE')) define('DOKU_BASE',getBaseURL());
57ed7b5f09Sandi  if(!defined('DOKU_URL'))  define('DOKU_URL',getBaseURL(true));
58ed7b5f09Sandi
59e71ce681SAndreas Gohr  // define cookie and session id
60e71ce681SAndreas Gohr  if (!defined('DOKU_COOKIE')) define('DOKU_COOKIE', 'DW'.md5(DOKU_URL));
61e71ce681SAndreas Gohr
62ee20e7d1Sandi  // define Plugin dir
63f62ea8a1Sandi  if(!defined('DOKU_PLUGIN'))  define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/');
64ee20e7d1Sandi
65ed7b5f09Sandi  // define main script
66ed7b5f09Sandi  if(!defined('DOKU_SCRIPT')) define('DOKU_SCRIPT','doku.php');
67ed7b5f09Sandi
686b13307fSandi  // define Template baseURL
696b13307fSandi  if(!defined('DOKU_TPL')) define('DOKU_TPL',
70f62ea8a1Sandi                                  DOKU_BASE.'lib/tpl/'.$conf['template'].'/');
716b13307fSandi
7278a6aeb1SAndreas Gohr  // define real Template directory
7378a6aeb1SAndreas Gohr  if(!defined('DOKU_TPLINC')) define('DOKU_TPLINC',
7478a6aeb1SAndreas Gohr                                  DOKU_INC.'lib/tpl/'.$conf['template'].'/');
7578a6aeb1SAndreas Gohr
76ed7b5f09Sandi  // make session rewrites XHTML compliant
773fc74836Sandi  @ini_set('arg_separator.output', '&amp;');
78ed7b5f09Sandi
793138b5c7SAndreas Gohr  // enable gzip compression
803138b5c7SAndreas Gohr  if ($conf['gzip_output'] &&
813138b5c7SAndreas Gohr      !defined('DOKU_DISABLE_GZIP_OUTPUT') &&
823138b5c7SAndreas Gohr      function_exists('ob_gzhandler') &&
833138b5c7SAndreas Gohr      preg_match('/gzip|deflate/', $_SERVER['HTTP_ACCEPT_ENCODING'])) {
843138b5c7SAndreas Gohr    ob_start('ob_gzhandler');
853138b5c7SAndreas Gohr  }
863138b5c7SAndreas Gohr
87ed7b5f09Sandi  // init session
886534245aSAndreas Gohr  if (!headers_sent() && !defined('NOSESSION')){
89ed7b5f09Sandi    session_name("DokuWiki");
90f77429b8SAndreas Gohr    session_set_cookie_params(0, DOKU_BASE);
91bad31ae9SAndreas Gohr    session_start();
92bad31ae9SAndreas Gohr  }
93ed7b5f09Sandi
94ed7b5f09Sandi  // kill magic quotes
95e55eb89cSAndreas Gohr  if (get_magic_quotes_gpc() && !defined('MAGIC_QUOTES_STRIPPED')) {
96ed7b5f09Sandi    if (!empty($_GET))    remove_magic_quotes($_GET);
97ed7b5f09Sandi    if (!empty($_POST))   remove_magic_quotes($_POST);
98ed7b5f09Sandi    if (!empty($_COOKIE)) remove_magic_quotes($_COOKIE);
99ed7b5f09Sandi    if (!empty($_REQUEST)) remove_magic_quotes($_REQUEST);
10056146e0dSAndreas Gohr#    if (!empty($_SESSION)) remove_magic_quotes($_SESSION); #FIXME needed ?
1013fc74836Sandi    @ini_set('magic_quotes_gpc', 0);
102e55eb89cSAndreas Gohr    define('MAGIC_QUOTES_STRIPPED',1);
103ed7b5f09Sandi  }
1043fc74836Sandi  @set_magic_quotes_runtime(0);
1053fc74836Sandi  @ini_set('magic_quotes_sybase',0);
106ed7b5f09Sandi
107ed7b5f09Sandi  // disable gzip if not available
108fe893490SAndreas Gohr  if($conf['compression'] == 'bz' && !function_exists('bzopen')){
109fe893490SAndreas Gohr    $conf['compression'] = 'gz';
110501252a5SAndreas Gohr  }
111fe893490SAndreas Gohr  if($conf['compression'] == 'gz' && !function_exists('gzopen')){
112501252a5SAndreas Gohr    $conf['compression'] = 0;
113ed7b5f09Sandi  }
114ed7b5f09Sandi
1151ca31cfeSAndreas Gohr  // precalculate file creation modes
1161ca31cfeSAndreas Gohr  init_creationmodes();
117ed7b5f09Sandi
1183dc3a5f1Sandi  // make real paths and check them
11998407a7aSandi  init_paths();
1207367b368SAndreas Gohr  init_files();
121ed7b5f09Sandi
1228c4f28e8Sjan  // automatic upgrade to script versions of certain files
123e7cb32dcSAndreas Gohr  scriptify(DOKU_CONF.'users.auth');
124e7cb32dcSAndreas Gohr  scriptify(DOKU_CONF.'acl.auth');
125f62ea8a1Sandi
126f62ea8a1Sandi
127f62ea8a1Sandi/**
12898407a7aSandi * Checks paths from config file
12998407a7aSandi */
13098407a7aSandifunction init_paths(){
13198407a7aSandi  global $conf;
13298407a7aSandi
13398407a7aSandi  $paths = array('datadir'   => 'pages',
13498407a7aSandi                 'olddir'    => 'attic',
13598407a7aSandi                 'mediadir'  => 'media',
13698407a7aSandi                 'metadir'   => 'meta',
13798407a7aSandi                 'cachedir'  => 'cache',
138579b0f7eSTNHarris                 'indexdir'  => 'index',
13971726d78SBen Coburn                 'lockdir'   => 'locks');
14098407a7aSandi
14198407a7aSandi  foreach($paths as $c => $p){
142bb4866bdSchris    if(empty($conf[$c]))  $conf[$c] = $conf['savedir'].'/'.$p;
14398407a7aSandi    $conf[$c]             = init_path($conf[$c]);
144*1983acc2SGuy Brand    if(empty($conf[$c]))  nice_die("The $c ('$p') does not exist, isn't accessible or writable.
14569dc3177SAndreas Gohr                               You should check your config and permission settings.
14669dc3177SAndreas Gohr                               Or maybe you want to <a href=\"install.php\">run the
14769dc3177SAndreas Gohr                               installer</a>?");
14898407a7aSandi  }
14971726d78SBen Coburn
15071726d78SBen Coburn  // path to old changelog only needed for upgrading
15171726d78SBen Coburn  $conf['changelog_old'] = init_path((isset($conf['changelog']))?($conf['changelog']):($conf['savedir'].'/changes.log'));
15271726d78SBen Coburn  if ($conf['changelog_old']=='') { unset($conf['changelog_old']); }
15371726d78SBen Coburn  // hardcoded changelog because it is now a cache that lives in meta
15471726d78SBen Coburn  $conf['changelog'] = $conf['metadir'].'/_dokuwiki.changes';
15598407a7aSandi}
15698407a7aSandi
15798407a7aSandi/**
1580d8850c4SAndreas Gohr * Checks the existance of certain files and creates them if missing.
1597367b368SAndreas Gohr */
1607367b368SAndreas Gohrfunction init_files(){
1617367b368SAndreas Gohr  global $conf;
1620d8850c4SAndreas Gohr
163579b0f7eSTNHarris  $files = array( $conf['indexdir'].'/page.idx');
1647367b368SAndreas Gohr
1657367b368SAndreas Gohr  foreach($files as $file){
1667367b368SAndreas Gohr    if(!@file_exists($file)){
1670d8850c4SAndreas Gohr      $fh = @fopen($file,'a');
1680d8850c4SAndreas Gohr      if($fh){
1697367b368SAndreas Gohr        fclose($fh);
1701ca31cfeSAndreas Gohr        if($conf['fperm']) chmod($file, $conf['fperm']);
1710d8850c4SAndreas Gohr      }else{
1723816dcbcSAndreas Gohr        nice_die("$file is not writable. Check your permissions settings!");
1730d8850c4SAndreas Gohr      }
1747367b368SAndreas Gohr    }
1757367b368SAndreas Gohr  }
1767367b368SAndreas Gohr}
1777367b368SAndreas Gohr
1787367b368SAndreas Gohr/**
1790d8850c4SAndreas Gohr * Returns absolute path
180f62ea8a1Sandi *
1810d8850c4SAndreas Gohr * This tries the given path first, then checks in DOKU_INC.
1820d8850c4SAndreas Gohr * Check for accessability on directories as well.
1830d8850c4SAndreas Gohr *
1840d8850c4SAndreas Gohr * @author Andreas Gohr <andi@splitbrain.org>
185f62ea8a1Sandi */
186f62ea8a1Sandifunction init_path($path){
1870d8850c4SAndreas Gohr  // check existance
188f62ea8a1Sandi  $p = realpath($path);
1890d8850c4SAndreas Gohr  if(!@file_exists($p)){
190f62ea8a1Sandi    $p = realpath(DOKU_INC.$path);
1910d8850c4SAndreas Gohr    if(!@file_exists($p)){
1928fc4e739Sandi      return '';
193f62ea8a1Sandi    }
1940d8850c4SAndreas Gohr  }
1950d8850c4SAndreas Gohr
1960d8850c4SAndreas Gohr  // check writability
1970d8850c4SAndreas Gohr  if(!@is_writable($p)){
1980d8850c4SAndreas Gohr    return '';
1990d8850c4SAndreas Gohr  }
2000d8850c4SAndreas Gohr
2010d8850c4SAndreas Gohr  // check accessability (execute bit) for directories
2020d8850c4SAndreas Gohr  if(@is_dir($p) && !@file_exists("$p/.")){
2030d8850c4SAndreas Gohr    return '';
2040d8850c4SAndreas Gohr  }
2050d8850c4SAndreas Gohr
2060d8850c4SAndreas Gohr  return $p;
2070d8850c4SAndreas Gohr}
2088c4f28e8Sjan
209ed7b5f09Sandi/**
2101ca31cfeSAndreas Gohr * Sets the internal config values fperm and dperm which, when set,
2111ca31cfeSAndreas Gohr * will be used to change the permission of a newly created dir or
2121ca31cfeSAndreas Gohr * file with chmod. Considers the influence of the system's umask
2131ca31cfeSAndreas Gohr * setting the values only if needed.
2141ca31cfeSAndreas Gohr */
2151ca31cfeSAndreas Gohrfunction init_creationmodes(){
2161ca31cfeSAndreas Gohr  global $conf;
2171ca31cfeSAndreas Gohr
2181ca31cfeSAndreas Gohr  // Legacy support for old umask/dmask scheme
2191ca31cfeSAndreas Gohr  unset($conf['dmask']);
2201ca31cfeSAndreas Gohr  unset($conf['fmask']);
2211ca31cfeSAndreas Gohr  unset($conf['umask']);
2221ca31cfeSAndreas Gohr  unset($conf['fperm']);
2231ca31cfeSAndreas Gohr  unset($conf['dperm']);
2241ca31cfeSAndreas Gohr
2259f3cdec3SAndreas Gohr  // get system umask, fallback to 0 if none available
2269f3cdec3SAndreas Gohr  $umask = @umask();
2279f3cdec3SAndreas Gohr  if(!$umask) $umask = 0000;
2281ca31cfeSAndreas Gohr
2291ca31cfeSAndreas Gohr  // check what is set automatically by the system on file creation
2301ca31cfeSAndreas Gohr  // and set the fperm param if it's not what we want
2311ca31cfeSAndreas Gohr  $auto_fmode = 0666 & ~$umask;
2321ca31cfeSAndreas Gohr  if($auto_fmode != $conf['fmode']) $conf['fperm'] = $conf['fmode'];
2331ca31cfeSAndreas Gohr
2341ca31cfeSAndreas Gohr  // check what is set automatically by the system on file creation
2351ca31cfeSAndreas Gohr  // and set the dperm param if it's not what we want
2361ca31cfeSAndreas Gohr  $auto_dmode = $conf['dmode'] & ~$umask;
2371ca31cfeSAndreas Gohr  if($auto_dmode != $conf['dmode']) $conf['dperm'] = $conf['dmode'];
2381ca31cfeSAndreas Gohr}
2391ca31cfeSAndreas Gohr
2401ca31cfeSAndreas Gohr/**
241ed7b5f09Sandi * remove magic quotes recursivly
242ed7b5f09Sandi *
243ed7b5f09Sandi * @author Andreas Gohr <andi@splitbrain.org>
244ed7b5f09Sandi */
245ed7b5f09Sandifunction remove_magic_quotes(&$array) {
246ed7b5f09Sandi  foreach (array_keys($array) as $key) {
247ed7b5f09Sandi    if (is_array($array[$key])) {
248ed7b5f09Sandi      remove_magic_quotes($array[$key]);
249ed7b5f09Sandi    }else {
250ed7b5f09Sandi      $array[$key] = stripslashes($array[$key]);
251ed7b5f09Sandi    }
252ed7b5f09Sandi  }
253ed7b5f09Sandi}
254ed7b5f09Sandi
255ed7b5f09Sandi/**
256ed7b5f09Sandi * Returns the full absolute URL to the directory where
257ed7b5f09Sandi * DokuWiki is installed in (includes a trailing slash)
258ed7b5f09Sandi *
259ed7b5f09Sandi * @author Andreas Gohr <andi@splitbrain.org>
260ed7b5f09Sandi */
261ed7b5f09Sandifunction getBaseURL($abs=false){
262ed7b5f09Sandi  global $conf;
263ed7b5f09Sandi  //if canonical url enabled always return absolute
264ed7b5f09Sandi  if($conf['canonical']) $abs = true;
265ed7b5f09Sandi
26692b83b77Sandi  if($conf['basedir']){
267919eeb46Sandi    $dir = $conf['basedir'].'/';
26889aa05dbSAndreas Gohr  }elseif(substr($_SERVER['SCRIPT_NAME'],-4) == '.php'){
269bdc127a4Sandi    $dir = dirname($_SERVER['SCRIPT_NAME']).'/';
27089aa05dbSAndreas Gohr  }elseif(substr($_SERVER['PHP_SELF'],-4) == '.php'){
27189aa05dbSAndreas Gohr    $dir = dirname($_SERVER['PHP_SELF']).'/';
272093ec9e4Sandi  }elseif($_SERVER['DOCUMENT_ROOT'] && $_SERVER['SCRIPT_FILENAME']){
273093ec9e4Sandi    $dir = preg_replace ('/^'.preg_quote($_SERVER['DOCUMENT_ROOT'],'/').'/','',
274093ec9e4Sandi                         $_SERVER['SCRIPT_FILENAME']);
275093ec9e4Sandi    $dir = dirname('/'.$dir).'/';
27692b83b77Sandi  }else{
27789aa05dbSAndreas Gohr    $dir = './'; //probably wrong
27892b83b77Sandi  }
279ed7b5f09Sandi
280ed7b5f09Sandi  $dir = str_replace('\\','/',$dir); #bugfix for weird WIN behaviour
281ed7b5f09Sandi  $dir = preg_replace('#//+#','/',$dir);
282ed7b5f09Sandi
283f62ea8a1Sandi  //handle script in lib/exe dir
284f62ea8a1Sandi  $dir = preg_replace('!lib/exe/$!','',$dir);
285f62ea8a1Sandi
286488d5fa0SMichael Klier chi@chimeric.de  //handle script in lib/plugins dir
287488d5fa0SMichael Klier chi@chimeric.de  $dir = preg_replace('!lib/plugins/.*$!','',$dir);
288488d5fa0SMichael Klier chi@chimeric.de
289ed7b5f09Sandi  //finish here for relative URLs
290ed7b5f09Sandi  if(!$abs) return $dir;
291ed7b5f09Sandi
292ef7b3ecdSAndreas Gohr  //use config option if available
293ef7b3ecdSAndreas Gohr  if($conf['baseurl']) return $conf['baseurl'].$dir;
294ef7b3ecdSAndreas Gohr
295e82e3526SAndreas Gohr  //split hostheader into host and port
296e82e3526SAndreas Gohr  list($host,$port) = explode(':',$_SERVER['HTTP_HOST']);
297e82e3526SAndreas Gohr  if(!$port)  $port = $_SERVER['SERVER_PORT'];
298e82e3526SAndreas Gohr  if(!$port)  $port = 80;
299ed7b5f09Sandi
300ed7b5f09Sandi  // see if HTTPS is enabled - apache leaves this empty when not available,
301ed7b5f09Sandi  // IIS sets it to 'off', 'false' and 'disabled' are just guessing
302ed7b5f09Sandi  if (preg_match('/^(|off|false|disabled)$/i',$_SERVER['HTTPS'])){
303ed7b5f09Sandi    $proto = 'http://';
304e82e3526SAndreas Gohr    if ($port == '80') {
305ed7b5f09Sandi      $port='';
306ed7b5f09Sandi    }
307ed7b5f09Sandi  }else{
308ed7b5f09Sandi    $proto = 'https://';
309e82e3526SAndreas Gohr    if ($port == '443') {
310ed7b5f09Sandi      $port='';
311ed7b5f09Sandi    }
312ed7b5f09Sandi  }
313ed7b5f09Sandi
314e82e3526SAndreas Gohr  if($port) $port = ':'.$port;
315e82e3526SAndreas Gohr
316ed7b5f09Sandi  return $proto.$host.$port.$dir;
317ed7b5f09Sandi}
318ed7b5f09Sandi
319b000c6d4Sandi/**
320b000c6d4Sandi * Append a PHP extension to a given file and adds an exit call
321b000c6d4Sandi *
322b000c6d4Sandi * This is used to migrate some old configfiles. An added PHP extension
323b000c6d4Sandi * ensures the contents are not shown to webusers even if .htaccess files
324b000c6d4Sandi * do not work
325b000c6d4Sandi *
326b000c6d4Sandi * @author Jan Decaluwe <jan@jandecaluwe.com>
327b000c6d4Sandi */
3288c4f28e8Sjanfunction scriptify($file) {
3298c4f28e8Sjan  // checks
3308c4f28e8Sjan  if (!is_readable($file)) {
3318c4f28e8Sjan    return;
3328c4f28e8Sjan  }
3338c4f28e8Sjan  $fn = $file.'.php';
3348c4f28e8Sjan  if (@file_exists($fn)) {
3358c4f28e8Sjan    return;
3368c4f28e8Sjan  }
3378c4f28e8Sjan  $fh = fopen($fn, 'w');
3388c4f28e8Sjan  if (!$fh) {
3393816dcbcSAndreas Gohr    nice_die($fn.' is not writable. Check your permission settings!');
3408c4f28e8Sjan  }
3418c4f28e8Sjan  // write php exit hack first
3428c4f28e8Sjan  fwrite($fh, "# $fn\n");
3438c4f28e8Sjan  fwrite($fh, '# <?php exit()?>'."\n");
3448c4f28e8Sjan  fwrite($fh, "# Don't modify the lines above\n");
3458c4f28e8Sjan  fwrite($fh, "#\n");
3468c4f28e8Sjan  // copy existing lines
3478c4f28e8Sjan  $lines = file($file);
3488c4f28e8Sjan  foreach ($lines as $line){
3498c4f28e8Sjan    fwrite($fh, $line);
3508c4f28e8Sjan  }
3513ba793e2Sandi  fclose($fh);
352b000c6d4Sandi  //try to rename the old file
3533aee4c27SAndreas Gohr  io_rename($file,"$file.old");
3548c4f28e8Sjan}
3558c4f28e8Sjan
3563816dcbcSAndreas Gohr/**
3573816dcbcSAndreas Gohr * print a nice message even if no styles are loaded yet.
3583816dcbcSAndreas Gohr */
3593816dcbcSAndreas Gohrfunction nice_die($msg){
3603816dcbcSAndreas Gohr  echo<<<EOT
3613816dcbcSAndreas Gohr  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
3623816dcbcSAndreas Gohr   "http://www.w3.org/TR/html4/loose.dtd">
3633816dcbcSAndreas Gohr  <html>
3643816dcbcSAndreas Gohr    <head><title>DokuWiki Setup Error</title></head>
3653816dcbcSAndreas Gohr    <body style="font-family: Arial, sans-serif">
3663816dcbcSAndreas Gohr      <div style="width:60%; margin: auto; background-color: #fcc;
3673816dcbcSAndreas Gohr                  border: 1px solid #faa; padding: 0.5em 1em;">
3683816dcbcSAndreas Gohr      <h1 style="font-size: 120%">DokuWiki Setup Error</h1>
3693816dcbcSAndreas Gohr      <p>$msg</p>
3703816dcbcSAndreas Gohr      </div>
3713816dcbcSAndreas Gohr    </body>
3723816dcbcSAndreas Gohr  </html>
3733816dcbcSAndreas GohrEOT;
3743816dcbcSAndreas Gohr  exit;
3753816dcbcSAndreas Gohr}
3763816dcbcSAndreas Gohr
377ed7b5f09Sandi
378340756e4Sandi//Setup VIM: ex: et ts=2 enc=utf-8 :
379