X-Git-Url: https://git.p6c8.net/devedit.git/blobdiff_plain/1fbf10bec35aeb289a9cf3e1c65a826883bffdea..40f2eee5acdbe92aca68f47ffc6ee15aa3035f7e:/README?ds=inline diff --git a/README b/README index c20d6fa..16cf24c 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ -ReadMe for Dev-Editor 3.0 (CVS) -=============================== +ReadMe for Dev-Editor 3.0.1 +=========================== Description ----------- @@ -29,7 +29,7 @@ Configuration ------------- Open the file devedit.conf. This file contains keys and values separated by a -"=" sign. +"=" sign. Lines beginning with a "#" sign are ignored. Here is a list of the configuration options currently available: Option Description @@ -82,9 +82,16 @@ use_gmt Set this option to 1 if you want to use Greenwich Mean Time (GMT/UTC) in directory listing and in the About dialogue instead of the local time. -forbidden Specify . The filenames have to be separated by space characters. - If a filename contains space characters, you have to - put it into double quotation marks ("/filename"). +forbidden Specify a list of filenames the user is not allowed to + access. The filenames have to be relative to the + virtual root directory (they must also begin with a + slash) and have to be separated by space characters. If + a filename contains space characters, you have to put + it into double quotation marks ("/filename"). + +userconf_file Specifies the path to a file which contains + user-dependent configuration options (see next section + for details). error_file The path to the file which defines the error messages. The file has the same format as this one. @@ -93,6 +100,56 @@ template_file The path to the file which defines the paths to the template files. The file has the same format as this one. +User-dependent configuration +---------------------------- + +If you have placed Dev-Editor inside a directory protected using HTTP +authentication, you may override some default configuration values for a defined +list of users. You may override the values for "fileroot", "httproot" and +"forbidden". + +For overriding configuration values you need a special configuration file. The +path to this file is defined using the "userconf_file" configuration option in +the main configuration file (add the option if necessary). This file consists of +key-value-pairs and sections, marked by a string encapsulated in square brackets +(perhaps you know this format, it is nearly the same as the Windows INI files). +Each section in this file describes an individual configuration, whereby the +name of the section is the username for whom this configuration should be used. +Here is an example: + +[homer] +fileroot = /var/www/homer/htdocs +httproot = / + +This sets the physical file root directory to "/var/www/homer/htdocs" and the +virtual HTTP root to "/" - but only for the user whose HTTP authentication +username is "homer". + +Using the "aliases" option, you may also define some other usernames for whom +this configuration should be used: + +[homer] +fileroot = /var/www/homer/htdocs +httproot = / +aliases = marge bart + +Using this, the users whose usernames are "marge" and "bart" use the same +configuration as "homer". Place any number of username seperated by whitespaces +here. +Note: If one of the users mentioned as an alias and an individual configuration +section for this user exists too, the one mentioned as an alias is ignored. + +If there are some files marked as inaccessible using the "forbidden" +configuration option in the main configuration file, but some users should have +access to these files, you may clear the default value of "forbidden": + +[homer] +fileroot = /var/www/homer/htdocs +httproot = / +forbidden = + +Using this, "homer" has access to all files in "/var/www/homer/htdocs". + Notes -----