X-Git-Url: https://git.p6c8.net/devedit.git/blobdiff_plain/d8d635a1b1d6d9ffa05f3cfaaa6d8bf9d2b9bf81..1a37b41caf7b9bfbc6a52c590b0908e9f7e61f73:/README diff --git a/README b/README index 361c3f8..dc80581 100644 --- a/README +++ b/README @@ -1,14 +1,31 @@ -ReadMe for Dev-Editor 3.x.x -=========================== +ReadMe for Dev-Editor 3.2 +========================= Description ----------- Dev-Editor is a simple CGI based editor written in Perl and licensed under the -terms of the Artistic License, which allows remote changes to files and +terms of the Artistic License 2.0, which allows remote changes to files and directory structures on a web server. That's useful if you aren't able to access the files on your homepage directly, for example if you are on holiday. +Features +-------- + +- Browsing through directory structures +- Viewing text files +- Editing text files +- Removing files and directories +- Moving/renaming files and directories +- Copying files and directories +- Creating new files and directories +- Executing a HTTP download of a file +- Uploading files to the server via HTTP +- Changing permissions (chmod) and group (chgrp) of files and directories (on + Unix systems) +- Unpacking some types of archive files (Perl module Archive::Extract is + required - core module since Perl 5.10, I guess) + Installation ------------ @@ -17,7 +34,7 @@ are able to execute scripts (in most cases, this is "cgi-bin"). I suggest to create a sub directory for Dev-Editor. Then, you have to change the first line of devedit.pl: Just replace /usr/bin/perl by the path to your Perl interpreter. -If you are on a UNIX based system, you have to set devedit.pl as executable +If you are on a Unix based system, you have to set devedit.pl as executable (chmod 755 in most cases). You will also need to configure Dev-Editor. See the next section for details. @@ -44,6 +61,9 @@ httproot This is the equivalent HTTP URL to the root directory. It's just used for visual output, so it doesn't need to be correct. +startdir Here you may define the default directory Dev-Editor + opens on start. + max_file_size Here you may define a maximum size for files (Bytes). If the user wants to view or edit a file larger than this defined size, Dev-Editor denies file access (but @@ -94,7 +114,13 @@ forbidden Specify a list of filenames the user is not allowed to 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"). + it into double quotation marks ("/file name"). + +disable_commands Specify a list of commands the user is not allowed to + execute. The commands have to be separated by space + characters. + If you add "@write" to the list, all writing commands + (for example edit, copy, rename etc.) get disabled. userconf_file Specifies the path to a file which contains user-dependent configuration options (see next section @@ -117,8 +143,10 @@ options: - fileroot - httproot +- startdir - hide_dot_files - forbidden +- disable_commands For overriding configuration values you need a special configuration file. The path to this file is defined using the "userconf_file" configuration option in @@ -180,7 +208,7 @@ Hard links are not affected by this. ------------------------------------------------ (C) 1999-2000 Roland Bluethgen, Frank Schoenmann -(C) 2003-2009 Patrick Canterino +(C) 2003-2011 Patrick Canterino E-Mail: patrick@patshaping.de WWW: http://devedit.sourceforge.net/ \ No newline at end of file