Commits

Iñigo Serna  committed bfd8519

Updated documentation. Prepare for next release.

* README (summary): added inigo.katxi.org as home page
* README (requirements): mention lfm requires python v2.5+ now
* README (download): added link to BitBucket repository
* README (faq): added example for fuse + webdav

* lfm/lfm.py (PowerCLI.execute): "except XXX as YYY" only valid for python v2.6+

  • Participants
  • Parent commits b2ab950

Comments (0)

Files changed (13)

+Sun May  8 01:52:14 2011  Iñigo Serna  <inigoserna@gmail.com>
+
+	* README (summary): added inigo.katxi.org as home page
+	* README (requirements): mention lfm requires python v2.5+ now
+	* README (download): added link to BitBucket repository
+	* README (faq): added example for fuse + webdav
+
+Sun May  8 01:09:50 2011  Iñigo Serna  <inigoserna@gmail.com>
+
+	* lfm/lfm.py (PowerCLI.execute): "except XXX as YYY" only valid for python v2.6+
+
 Sun May  8 00:51:00 2011  Iñigo Serna  <inigoserna@gmail.com>
 
 	* lfm/actions.py (file_menu): we should not compress '..'
+Version 2.3 ("XXX") - 2011/XX/XX:
+
+  + New features
+
+
 Version 2.2 ("Approaching perfection") - 2010/05/22:
 
   + New features
       . new command line flag -s/--stdin to force reading from stdin.
         Now pyview doesn't wait for stdin input by default, so it starts much
         faster. eg. $ ps efax | pyview -s
-    
+
   + Minor changes
     - add color entries for directories and exe_files
     - expand ~ to user home
     - show file info rewritten, now it shows correctly information
       from fuse-mounted volumes
     - added new "ebook" category, filetypes and formats
-  
+
   + About the code
     - since python v2.6+, popen* is deprecated, so make lfm check python
       version and use popen* or subprocess accordingly
 Version 2.1 ("What do you want for Christimas?") - 2008/12/21:
 
   + Ctrl-H now show/hide dot files
-  + Ctrl-Y display directories history 
+  + Ctrl-Y display directories history
   + It's now posible to move the cursor in the non-active pane
     Consult the documentation for available keys and actions
     This behaviour is de/activated with Ctrl-W
       . delete garbage if user stops action
       . run 'do_special_view_file' as dettached from lfm window
       . path expand in bookmarks ("~/") [Andrey Skvortsov]
-      . an ugly traceback crash appears when user starts "lfm path" and has 
-        no permissions to enter. Show error message and default to current 
+      . an ugly traceback crash appears when user starts "lfm path" and has
+        no permissions to enter. Show error message and default to current
         directory
-      . lfm crashes when filename is not encoded with same codec than 
-        g_encoding utils.{decode|encode}. Needs curses module linked against 
+      . lfm crashes when filename is not encoded with same codec than
+        g_encoding utils.{decode|encode}. Needs curses module linked against
         ncursesw to work properly
       . sort_mix_cases = 1 performance degrades on larger dirs.
         Reported by Andrey Skvortsov
       . dialogs appear at bad position after terminal is resized
       . handle window resize in Tree mode
       . refresh display after canceling completion dialog
-      . "the size of the right pane does not fill the last column in 
+      . "the size of the right pane does not fill the last column in
         terminal if their number is odd" [Andrey Skvortsov]
-      . fix crash when "df" shows entries in two different lines (device 
+      . fix crash when "df" shows entries in two different lines (device
         name is too large, f.e. in linux lvm2 volumes)
-      . if you try to enter a directory with insufficient permissions, after 
+      . if you try to enter a directory with insufficient permissions, after
         the error message is closed the cursorline refreshes to the first line
     - compress:
       . added -i flag (--ignore-zeros) flag to tar [Andrey Skvortsov]
       . standard tar needs - for flags
     - vfs:
-      . vfs.py: regenerate_file, if user stops process, tempfile can't be 
+      . vfs.py: regenerate_file, if user stops process, tempfile can't be
         deleted
     - find/grep:
       . escape special chars (- \ ( ) [ ]) in patterns
   + quite stable and robust, doesn't crash
   + faster
   + new option: show_dotfiles flag
-  + new option: detach_terminal_at_exec flag: useful f.e. if you 
+  + new option: detach_terminal_at_exec flag: useful f.e. if you
     want to run elinks as web browser attached to lfm terminal
   + file associations and applications can be configured in preferences
   + now each application has only 1 associated program, *breaking old .lfmrc*
           * "messages.SelectItem, messages.FindfilesWin, messages.MenuWin,
             messages.ChangePerms: upperleft corner disappears"
           * findgrep: fix bug: if selected file has a ':' in name
-      - pyview: 
+      - pyview:
           * changing 'addch' by 'addstr' shows individual chars >= 0xA0 (meta
             chars) correctly, neither in reversed video or as 2 chars
-          * "if wrap mode => fix prev/next page & up/down cursor". Now 
+          * "if wrap mode => fix prev/next page & up/down cursor". Now
             they move to screen lines, not to physical lines
 
 
 
   + 'pyview', a new pager/viewer for use with lfm or standalone,
     internally or externally. It is used as default pager too.
-    Some features: Text / Hex view, backwards & forwards search, 
+    Some features: Text / Hex view, backwards & forwards search,
                    goto line/byte, un/wrap mode, documentation, ...
   + Rewrite 'show filesystems info' to use internal viewer
-  + New 'run_thread' function in which almost every proccess is executed, 
+  + New 'run_thread' function in which almost every proccess is executed,
     so they can be stopped and there is a working signal too.
     'do_something_on_file' does not use it
   + Implemented 'show file info'
 Metadata-Version: 1.0
 Name: lfm
-Version: 2.2
-Summary: Last File Manager is a simple but powerful file manager for the UNIX console
+Version: 2.3
+Summary: Last File Manager is a powerful file manager for the UNIX console
 Home-page: http://code.google.com/p/lfm/
 Author: Iñigo Serna
 Author-email: inigoserna@gmail.com
 
 :Author: Iñigo Serna, inigoserna AT gmail DOT com
 
-:Version: 2.2, May 22th. 2010
+:Version: 2.3, January XXth. 2011
 
-:Home page: http://www.terra.es/personal7/inigoserna/lfm/
+:Home page: https://inigo.katxi.org/devel/lfm/  or  http://www.terra.es/personal7/inigoserna/lfm/
 
-:License: \(C\) 2001-10, Iñigo Serna
+:License: \(C\) 2001-11, Iñigo Serna
 
           This software has been realised under the `GPL License`__ version 3
           or later, read the COPYING_ file that comes with this package for
 
           There is NO WARRANTY.
 
-:Last update: Thu Jul 22 20:56:34 2010
+:Last update: Sun May  8 01:24:59 2011
 
 .. contents:: Table of Contents
 
 Requirements
 ============
 *Lfm* and *Pyview* are written in Python_ and require curses module.
-It should run on Python v2.4 or higher, as but I'm only have v2.6 on my
+It should run on Python v2.5 or higher, but as I'm only have v2.7 on my
 computers I haven't tested older versions.
 
 All modern UNIX flavours (Linux, \*BSD, Solaris, etc) should run it without
 about support of different encodings.
 
 
-Download & Installation
-=======================
-.. sidebar:: Files: all versions
+Development, Download, Installation
+===================================
+.. sidebar:: **Files:** all releases
    :class: warning
 
    +---------+------------------+------------+
    | Version |       File       |    Date    |
    +=========+==================+============+
-   |   2.3   | lfm-2.3.tar.gz_  | 2010/XX/XX |
+   |   2.3   | lfm-2.3.tar.gz_  | 2011/XX/XX |
    +---------+------------------+------------+
    |   2.2   | lfm-2.2.tar.gz_  | 2010/05/22 |
    +---------+------------------+------------+
    Read about NEWS_ or ChangeLog_
 
 
+**Last File Manager** development can be followed in the `BitBucket mercurial repository`__.
+
 'lfm' is very easy to install, just keep next steps:
 
 1. Download sources_
 + **lfm does not change to current directory after quiting**
 
   This can't be made inside the program, but you could get it using
-  the shell tip mentioned in `Download & Installation`_ section.
+  the shell tip mentioned in `Development, Download, Installation`_ section.
 
 + **Why doesn't lfm implement remote vfs such as ssh, ftp, smb, webdav, ...?**
 
     $ mkdir mount_point_for_ftp_server
     $ curlftpfs ftp://user:password@ip_or_hostname mount_point_for_ftp_server
 
+  For webdav you need *fuse* and *wdfs* or davfs2 (non fuse based)::
+
+    $ mkdir mount_point_for_webdav_server
+    $ wdfs https://user:password@server.org/webdav_dir mount_point_for_webdav_server
+
+  For smb take a look at *fuse-smb*.
+
   And to umount::
 
     $ fusermount -u mount_point
 .. _mc: http://www.ibiblio.org/mc/
 .. _buerg: http://www.buerg.com/
 .. _python: http://www.python.org
+.. _BITBUCKETREPO: https://bitbucket.org/inigoserna/lfm
 __ GPL_
+__ BITBUCKETREPO_
 __ mc_
 __ buerg_
 .. _lfm-2.3.tar.gz: lfm-2.3.tar.gz

File README.pyview

 
 :Author: I�igo Serna, inigoserna AT gmail DOT com
 
-:Version: 2.2, May 22th. 2010
+:Version: 2.3, May XXth. 2011
 
 :Home page: http://www.terra.es/personal7/inigoserna/lfm/
 
-:License: \(C\) 2001-10, I�igo Serna
+:License: \(C\) 2001-11, I�igo Serna
 
           This software has been realised under the `GPL License`__ version 3
           or later, read the COPYING_ file that comes with this package for
-          more information. 
+          more information.
 
           There is NO WARRANTY.
 
-:Last update: Sat May 22 11:18:35 2010
+:Last update: Sun May  8 01:28:07 2011
 
 .. contents:: Table of Contents
 
 =======================
 Enter the line number / byte offset you want to show.
 If number / byte is preceded by `0x` it is interpreted as hexadecimal.
-You can scroll relative lines from the current position using '+' or '-' 
+You can scroll relative lines from the current position using '+' or '-'
 character.
 
 
 ============================================================================
-Last update:	Time-stamp: <2011-05-08 00:52:26 inigo>
+Last update:	Time-stamp: <2011-05-08 01:55:00 inigo>
 ============================================================================
 
-- min. python v2.5? RHEL5 ships 2.4, but it was released in sept 2006
-
 - update sites: katxi, terra, googlecode, freshmeat, cheeseshop, bitbucket
 - release & announce: python-lists*, cheeseshop, freshmeat
 
-
 Bugs:
 =====
 - show filesystem: ellipsize_middle if len(fs_name) > 22
 - find files: if results contain dir_with_spaces
-- "try: except Exception as", only python v2.6+
 
 General:
 ========
 1   - un/compress: .tar
 1   - catch exception in main
 1   - test and improve PowerCLI
-1   - v2.3, year 2011
 1   - don't like much how recursive chmod/chown/chgrp currently works
       . split in 2 different features chmod and chown/chgrp ?
 2   - pyview: tail mode:
       . option -f, document
       . powercli: |: run as tail -f, substitute run sync by default, document
 2   - substitute curses.color_pair(X) for COL_XXX
-3   - remove do_something_on_file => use powercli
-3   - more than 10 bookmarks => letters
   + ui:
 1   - support for languages with wide chars
       . check the real length on screen of the utf8-encoded strings.
 2   - copy or move to: allow bookmarks: $b1
 2   - diff and sync dirs: use filecmp.dircmp or rsync
 1 + documentation:
-    - new examples for webdav:
-      . for webdab you need *fuse* and *wdfs*::
-          $ mkdir mount_point_for_webdav
-          $ wdfs https://user:password@server.ord/webdav_dir mount_point
-        Or davfs2 (non fuse based)
-      . for smb take a look at *fuse-smb*
-    - README: can follow development in https://bitbucket.org/inigoserna/lfm
     - document .lfmrc contents
+    - be sure release date is correct in all files
+    - update NEWS, clean TODO
 
 Low Priority (maybe some day):
+  + remove do_something_on_file => use powercli
+  + more than 10 bookmarks => letters
   + filter files (f.e. "*py" to only view python files)
   + emacs-like M-x to run internal commands
   + global copy/cut/paste between tabs or panes
   . README FAQ: added information about fuse ssh, ftp and webdav
   . mention python v2.5+
   . reorganized and fixed key bindings section
+  . added link to publick BitBucket repository
 
 THANKS:
 - yellowprotoss: feedback, ideas and copy/mkdir bugs report
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
 .SH NAME
-\fBlfm\fR \- a simple but powerful file manager for the UNIX console
+\fBlfm\fR \- a powerful file manager for the UNIX console
 
 .SH SYNOPSIS
 .BI "lfm [ -h | --help ] "
 .br
-.BI "    [ -d | --debug ]" 
+.BI "    [ -d | --debug ]"
 .br
 .BI "    [-1 | -2] [pathtodir1 [pathtodir2]]"
 .sp
 
 .SH DESCRIPTION
-.B Last File Manager 
-is a simple but powerful file manager for the
-UNIX console. It has been developed with the ol' good `Midnight
-Commander` as model.
+.B Last File Manager
+is a powerful file manager for the UNIX console. It has been developed
+with the ol' good `Midnight Commander` as model.
 
 .SH OPTIONS
 .TP
-.B "\-1"                  
+.B "\-1"
 start in 1-pane mode
 .TP
 .B "\-2"
 (but may be used by others).
 
 .SH SEE ALSO
-The full documentation which includes the keys descriptions is in 
+The full documentation which includes the keys descriptions is in
 /usr/share/doc/lfm/README.

File lfm/__init__.py

 # -*- coding: utf-8 -*-
 
 """
-Copyright (C) 2001-10, Iñigo Serna <inigoserna@gmail.com>.
+Copyright (C) 2001-11, Iñigo Serna <inigoserna@gmail.com>.
 All rights reserved.
 
 This software has been realised under the GPL License, see the COPYING
 
 ######################################################################
 AUTHOR = u'Iñigo Serna'
-VERSION = '2.2'
-DATE = '2001-10'
+VERSION = '2.3'
+DATE = '2001-11'
 
 LFM_NAME = 'lfm - Last File Manager'
 
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-# Copyright (C) 2001-10  Iñigo Serna
-# Time-stamp: <2010-05-22 11:22:27 inigo>
+# Copyright (C) 2001-11  Iñigo Serna
+# Time-stamp: <2011-05-08 01:31:02 inigo>
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 import sys
 from lfm.lfm import lfm_start
 
-if sys.version_info < (2, 4):
-    print "Python 2.4 or higher is required to run lfm."
+if sys.version_info < (2, 5):
+    print "Python 2.5 or higher is required to run lfm."
 else:
     lfm_start(sys.argv)
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-# Copyright (C) 2001-10  Iñigo Serna
-# Time-stamp: <2011-03-07 22:55:26 inigo>
+# Copyright (C) 2001-11  Iñigo Serna
+# Time-stamp: <2011-05-08 01:30:34 inigo>
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 
-u"""lfm v2.2 - (C) 2001-10, by Iñigo Serna <inigoserna@gmail.com>
+u"""lfm v2.3 - (C) 2001-11, by Iñigo Serna <inigoserna@gmail.com>
 
 'Last File Manager' is a file manager for UNIX console which born with
 midnight commander as model. Released under GNU Public License, read
 
 
 __author__ = u'Iñigo Serna'
-__revision__ = '2.2'
+__revision__ = '2.3'
 
 
 import os, os.path
             for f in selected:
                 try:
                     cmd = self.__replace_cli(cmd_orig, tab, selected, f)
-                except Exception as msg:
+                # except Exception as msg: # python v2.6+
+                except Exception, msg:
                     messages.error('Cannot execute PowerCLI command:\n  %s\n\n%s' % \
                                        (cmd_orig, str(msg)))
                     st = -1
         else:
             try:
                 cmd = self.__replace_cli(cmd_orig, tab, selected)
-            except Exception as msg:
+            # except Exception as msg: # python v2.6+
+            except Exception, msg:
                 messages.error('Cannot execute PowerCLI command:\n  %s\n\n%s' % \
                                    (cmd_orig, str(msg)))
             else:
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-# Copyright (C) 2001-10  Iñigo Serna
-# Time-stamp: <2010-05-22 11:22:17 inigo>
+# Copyright (C) 2001-11  Iñigo Serna
+# Time-stamp: <2011-05-08 01:30:50 inigo>
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 import sys
 from lfm.pyview import PyView
 
-if sys.version_info < (2, 4):
-    print "Python 2.4 or higher is required to run pyview."
+if sys.version_info < (2, 5):
+    print "Python 2.5 or higher is required to run pyview."
 else:
     PyView(sys.argv)

File lfm/pyview.py

 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-# Copyright (C) 2001-10  Iñigo Serna
-# Time-stamp: <2011-03-07 16:55:56 inigo>
+# Copyright (C) 2001-11  Iñigo Serna
+# Time-stamp: <2011-05-08 01:31:17 inigo>
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 
 
 """
-Copyright (C) 2001-10, Iñigo Serna <inigoserna@gmail.com>.
+Copyright (C) 2001-11, Iñigo Serna <inigoserna@gmail.com>.
 All rights reserved.
 
 This software has been released under the GPL License, see the COPYING
 # -*- coding: utf-8 -*-
 
 
-"""Last File Manager is a simple but powerful file manager for the UNIX console
+"""Last File Manager is a powerful file manager for the UNIX console
 It has been developed with the ol' good Midnight Commander as model."""
 
 
 
 
 setup(name = 'lfm',
-      version = '2.2',
+      version = '2.3',
       license = 'GPL',
       description = doclines[0],
       long_description = '\n'.join(doclines[2:]),