[Pkg-jed-commit] r330 - trunk/packages/jed/debian

Mon Jun 12 09:04:54 UTC 2006

Author: milde-guest
Date: 2006-06-12 09:04:53 +0000 (Mon, 12 Jun 2006)
New Revision: 330

Modified:
   trunk/packages/jed/debian/NEWS
   trunk/packages/jed/debian/README.Debian
   trunk/packages/jed/debian/changelog
   trunk/packages/jed/debian/control
Log:
Documentation update

Removed the conflict with jed-extra (<= 1.0-1) as jed-extra will not break 
jed|xjed (but some modes of jed-extra will be broken with jed using 
SLang2).

This should clear the way to upload jed, xjed, and jed-common to testing.




Modified: trunk/packages/jed/debian/NEWS
===================================================================

--- trunk/packages/jed/debian/NEWS	2006-06-09 21:33:23 UTC (rev 329)
+++ trunk/packages/jed/debian/NEWS	2006-06-12 09:04:53 UTC (rev 330)
@@ -2,13 +2,12 @@
 Recent changes to the Debian jed packages
 =========================================
 
-This is a listing of most important changes to the Debian Jed packages 
+This is a listing of most important changes to the Debian Jed packages
 intended for people upgrading from Sarge (0.99.16-5).
 
 See "changelog.Debian.gz" for a detailled list of Debian specific changes
 and "changelog.gz" for the upstream changes.
 
-
 Packages and contents
 ---------------------
 
@@ -25,49 +24,46 @@
 S-Lang Version 2
 ----------------
 
-* Jed now uses S-Lang Version: 2.0.5. There can be incompatibilities
+* Jed now uses S-Lang Version 2. There can be incompatibilities
   breaking home-made or downloaded extensions made for Slang-1.
+  This affects also some scripts in the jed-extra (1.0-1) package!
 
-  New features and upgrade information for version 2 are described in 
+  New features and upgrade information for version 2 are described in
   appendix A. "S-Lang 2 Interpreter NEWS" of
   /usr/share/doc/libslang2/slang.txt.
 
-
 UTF 8 support
 -------------
 
 * Unicode via the UTF-8 encoding is available for jed versions 0.99-17
-  and greater provided that slang2 is used.
+  and greater that use slang2.
 
-  However, this feature is new and still in beta stage. Not all library
+  This feature is new and still in beta stage. Not all library
   functions are tested with UTF-8 so expect some "teething problems".
-  
+
 * Enabling UTF-8 support: If the locale indicates that the character set is
   UTF-8, then UTF-8 mode will be enabled.
-  
-  Examples: 
-  
+
+  Examples:
+
     Start xjed in UTF-8 mode:     LANG=de_DE.UTF-8; xjed
     Start jed in non-UTF-8 mode:  LANG=de_DE; jed
-    
-    Alias for xjed in UTF-8 mode: alias ujed="LANG=de_DE.UTF-8; xjed"
-  
-  (The latter is in my ~/.bashrc.)
 
+    ~/.bashrc alias:              alias ujed="LANG=de_DE.UTF-8; xjed"
+
   There is no provision for enabling or disabling UTF-8 support during
   runtime.
 
-  More details under the menu topic 
-  
+  More details under the menu topic
+
     Help>Browse_Docs utf8
 
-
 Jed_Home_Directory
 ------------------
 
 * If the directory "~/.jed/" exists, it will become the `Jed_Home_Directory'
   and Jed will no longer search for "~/.jedrc" at startup.
-  
+
   The user needs to move an eventually existing "~/.jedrc" to
   "~/.jed/jed.rc" ("~/.jed/.jedrc" is still found but deprecated).
 
@@ -76,12 +72,11 @@
   eventually existing ~/.jedrc to ~/.jed/jed.rc (and ~/.jedrecent to
   ~.jed/.jedrecent).
 
-
 Motivation
 ''''''''''
 
 Debian Jed now supports a per-user "~/.jed/" application directory in
-accordance with the file hierarchy standard (FHS 2.3). 
+accordance with the file hierarchy standard (FHS 2.3).
 
   User specific configuration files for applications are stored in the
   user's home directory in a file that starts with the '.' character (a
@@ -90,18 +85,17 @@
   a '.' character, (a "dot directory"). In this case the configuration
   files should not start with the '.' character.
 
-
 Debian Jed startup scheme
 -------------------------
 
 * The Jed config directory is renamed from "/etc/jed-init.d/" to
   "/etc/jed.d".
-  
+
   If there are files in "/etc/jed-init.d/" that are unknown to jed-common,
   the old directory will remain in place (but not used). The sysadmin should
   check, manually move remaining files to "/etc/jed.d" and delete
   "/etc/jed-init.d/".
-  
+
 * The file "/etc/jed.conf" has been removed.
 
   "/usr/share/jed/lib/defaults.sl" contains the code to evaluate the files
@@ -112,12 +106,11 @@
 
 * Evalutation of "/etc/jed.d/" can be suppressed by the
   --skip-debian-startup command line option.
-  
+
 * "/etc/jed.d/" is not evaluated if Jed is started as `jed-script`.
-  
+
   If a script depends on the Debian configuration, it can call the function
   debian_startup() (defined in defaults.sl).
 
-
 For details see README.Debian-startup.
 

Modified: trunk/packages/jed/debian/README.Debian
===================================================================
--- trunk/packages/jed/debian/README.Debian	2006-06-09 21:33:23 UTC (rev 329)
+++ trunk/packages/jed/debian/README.Debian	2006-06-12 09:04:53 UTC (rev 330)
@@ -31,11 +31,10 @@
 Debian Jed's startup scheme provides for startup code from other packages.
 Instead of a config file, we use a config directory: At startup, Jed will
 evaluate all "*.sl" scripts in /etc/jed.d/. The sysadmin can modify or add
-files in /etc/jed.d/ for site-wide configuration.
+files in /etc/jed.d/ for site-wide configuration. See README.Debian-startup
+for details.
 
-See README.Debian-startup for details.
 
-
 Jed_Home_Directory
 ------------------
 
@@ -57,10 +56,8 @@
   templates/   optional dir for templates (with jed-extra)
 
 
-ATTENTION: If a user has a "~/.jed/" directory, Jed will not find a
-"~/.jedrc" startup file. The user must move an eventually existing
-"~/.jedrc" to "~/.jed/jed.rc". ("~/.jed/.jedrc" is still found but
-deprecated.)
+ATTENTION: If "~/.jed/" exists, Jed will not find a "~/.jedrc" startup file.
+The user needs to move an eventually existing "~/.jedrc" to "~/.jed/jed.rc".
 
 
 Some frequently asked questions
@@ -113,9 +110,11 @@
     line.
       
 Q: TAB does not generate a TAB! Why?
-A: Please see /usr/share/doc/jed-common/jed_faq.txt.gz, question #13.
+A: It does something more usefull: indenting the line according to the
+   mode's rules. Use `quoted_insert' for a hard TAB. For the full story, 
+   see /usr/share/doc/jed-common/jed_faq.txt.gz, question #13.
 
-Q: I expected Jed to make a difference between a single '/' and multiple '/'
+Q: Jed makes a difference between a single '/' and multiple '/'
    in pathnames - e.g. '/usr//bin/' is *not* equal to '/usr/bin/' ! Why?
 A: According to John E. Davis, the author, this is like Emacs behaves, too.
 
@@ -123,18 +122,19 @@
    foreground colours, yet Jed is still changing this, thus overriding the
    default colours of the terminal it's running in.  What's wrong?
 A: If you're only using set_color() calls but never call set_color_scheme(),
-   Jed automatically calls set_color_scheme() with the
-   _Jed_Default_Color_Scheme. So, to fix your problem, put
+   Jed uses the _Jed_Default_Color_Scheme. So, to fix your problem, put
    "_Jed_Default_Color_Scheme = NULL;" in your ~/.jedrc.
     
 Q: Why is jed linked against libncurses when it uses slang?
 A: Because it has GPM mouse support and these libraries need ncurses.
 
-Q: The configuration files seem somewhat confusing to me. Can you explain?
-A: See /usr/share/doc/jed-common/README.Debian-startup
+Q: My SLang scripts do no longer work.
+Q: After upgrading jed (or xjed), some jed-extra modes are broken.
+A: Since version 0.99.18, jed uses S-Lang 2. See "S-Lang 2 Interpreter NEWS"
+   of /usr/share/doc/libslang2/slang.txt for further explanation.
 
    
 .. Copyright (c) 2006 the Debian JED Group
    Released under the terms of the GNU General Public License (ver. 2 or later)
    
-   Last update 2006-05-16 Guenter Milde
+   Last update 2006-06-12 Guenter Milde

Modified: trunk/packages/jed/debian/changelog
===================================================================
--- trunk/packages/jed/debian/changelog	2006-06-09 21:33:23 UTC (rev 329)
+++ trunk/packages/jed/debian/changelog	2006-06-12 09:04:53 UTC (rev 330)
@@ -2,10 +2,18 @@
 
   NOT YET RELEASED !
 
-  * Documentation update (README.Debian, README.Debian-startup) [GM]
+  * Documentation update (NEWS, README.Debian, README.Debian-startup) [GM]
+    - document the (beta) UTF8 support with SLang2
+    - warn of SLang2 eventually breaking old *.sl scripts
+    - explain the Debian-special startup scheme
+     
 
   * debian/po/cs.po: Added Czech translations for debconf templates,
     thanks to Miroslav Kure <kurem at upcase.inf.upol.cz> [RL]
+    
+  * Removed the conflict with jed-extra (<= 1.0-1) as jed-extra will not break 
+    jed|xjed (but some modes of jed-extra will be broken with jed using 
+    SLang2). [GM]
 
  -- Rafael Laboissiere <rafael at debian.org>  Wed, 07 Jun 2006 13:48:13 +0200
 

Modified: trunk/packages/jed/debian/control
===================================================================
--- trunk/packages/jed/debian/control	2006-06-09 21:33:23 UTC (rev 329)
+++ trunk/packages/jed/debian/control	2006-06-12 09:04:53 UTC (rev 330)
@@ -9,7 +9,6 @@
 
 Package: jed
 Architecture: any
-Conflicts: jed-extra (<= 1.0-1)
 Depends: ${shlibs:Depends}, jed-common (>= ${Source-Version})
 Provides: info-browser, mail-reader, editor
 Description: editor for programmers (textmode version)
@@ -23,22 +22,21 @@
  expression search/replace; incremental searches; search/replace across
  multiple files; multiple windows; multiple buffers; ...
  .
- Programming modes (syntax highlighting, indention, compile, ...):
- Basic, C, C++, DCL, FORTRAN, HTML, IDL, Java, NROFF, Pascal,
+ Tools: directory editor (dired); info (browse GNU info files); mail;
+ rmail; ispell; shell mode; ...
+ .
+ Special modes (syntax highlight, indention, compile, ...) for
+ Basic, C, C++, DCL, FORTRAN, IDL, Java, NROFF, Pascal,
  Perl, PHP, PostScript, Python, SH.
- Supported markup languages include HTML and (La)TeX (with AUC-TeX style
+ Modes for markup languages include HTML and (La)TeX (with AUC-TeX style
  editing and BiBTeX)
  .
- Tools: directory editor (dired); info (browse GNU info files); mail;
- rmail; ispell; shell modes; ...
+ Additional tools and modes can be found in the jed-extra package.
  .
- Additional tools and modes are in the jed-extra package.
- .
   Homepage: http://www.jedsoft.org/jed/
 
 Package: xjed
 Architecture: any
-Conflicts: jed-extra (<= 1.0-1)
 Depends: ${shlibs:Depends}, jed-common (>= ${Source-Version})
 Provides: info-browser, mail-reader, editor
 Description: editor for programmers (x11 version)
@@ -53,16 +51,20 @@
  expression search/replace; incremental searches; search/replace across
  multiple files; multiple windows; multiple buffers; ...
  .
- Programming modes (syntax highlighting, indention, compile, ...):
- Basic, C, C++, DCL, FORTRAN, HTML, IDL, Java, NROFF, Pascal,
+ Special modes (syntax highlight, indention, compile, ...) for
+ Basic, C, C++, DCL, FORTRAN, IDL, Java, NROFF, Pascal,
  Perl, PHP, PostScript, Python, SH.
- Supported markup languages include HTML and (La)TeX (with AUC-TeX style
+ Modes for markup languages include HTML and (La)TeX (with AUC-TeX style
  editing and BiBTeX)
  .
  Tools: directory editor (dired); info (browse GNU info files); mail;
- rmail; ispell; shell modes; ...
+ rmail; ispell; shell mode; ...
  .
- Additional tools and modes are in the jed-extra package.
+ The native X11 version provides improved mouse support, key configuration
+ and X selection interaction. If no display is available, xjed falls back to
+ text mode, thus there is no need to install both jed and xjed packages.
+ .  
+ Additional tools and modes can be found in the jed-extra package.
  .
   Homepage: http://www.jedsoft.org/jed/
 


