ci before tagging 14.5.1

A-M_in-depth_tutorial.org

@@ -88,8 +88,6 @@
    applications WorkBench is taking over the "code authoring" part
    from the user, use APDL for *repetitive* tasks and command
    snippets, *extending* WB.
-
-
 
 ** Target audience  
    - APDL coders :: You have repetitive tasks and write APDL
@@ -102,17 +100,19 @@
         command reference.
 ** Using this tutorial
 *** Please read the *introductory* ANSYS-Mode tutorial first
-    It is `ansys-mode_tutorial.pdf' or use its [[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/ansys-mode_tutorial.html][online]] version.
+    This is the file `A-M_introductory_tutorial-14.5.1.pdf' in the
+    mode's archive or use its [[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/A-M_introductory_tutorial.html][online]] version.
 
-    Ah yes, you are in a hurry, I thought so. *In summary:* You will
-    get an illustrated overiew how ANSYS-Mode can improve your
+    Ah yes, you are in a hurry (I thought so). *In summary:* You
+    will get an illustrated overiew how ANSYS-Mode can improve your
     workflows and that the software is available without any costs and
     with (practically) no license restrictions also for commercial
     use.
 
-    Simply download an archive, extract it anywhere without the need
-    of administrator rights.  For the Windows version all system
-    independent things should run without any configuration.
+    Simply download the proper mode archive, extract it anywhere. For
+    the Windows version with the pre-configured mode all system
+    independent things should run without the need of any
+    configuration.
 
    In the following *bold* character combinations like *C-c* or *M-c*
    mean typing the <CTRL> key or <ALT> (formerly called `Meta') key
@@ -999,7 +999,7 @@ The APDL processing and debugging environment
    !@ ==============================
    !! Prerequisites:
    !! 1) A fully configured ANSYS-Mode and
-   !! 2) a Linux or UNIX system
+   !! 2) a Gnu/Linux or Gnu/Linux system
 #+end_src
   Finally switch off unnecessay stuff: Emacs' menu-, tool- and
   scroll-bar to get more screen estate.  :-) And tidying the window
@@ -1257,7 +1257,7 @@ Thank you for your time, have fun with Emacs...
 
 # # !!    mouse selection ->copy to clipboard
 # # !! 0.) mouse selection does not work under Windows mouse-drag-copy-region!
-# # !! mouse copy on Windows the same on Linux only if (setq mouse-drag-copy-region t)
+# # !! mouse copy on Windows the same on Gnu/Linux only if (setq mouse-drag-copy-region t)
 
 # #+begin_src ansys : tangle yes
 # ! continuation line with $

A-M_introductory_tutorial.org

@@ -13,7 +13,8 @@
 #+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js
 #+LaTeX_CLASS: beamer
 #+LaTeX_CLASS_OPTIONS: [presentation,colorlinks,t]
-##+BEAMER_HEADER_EXTRA: \beamertemplatenavigationsymbolsempty
+##+BEAMER_HEADER_EXTRA: \usepackage{hyperref}
+#+BEAMER_HEADER_EXTRA: \beamertemplatenavigationsymbolsempty
 #+BEAMER_HEADER_EXTRA: \setbeamertemplate{footline}[frame number]
 #+BEAMER_HEADER_EXTRA: \titlegraphic{\includegraphics[width=7cm]{./ansys+emacs.png}}
 #+LATEX_HEADER: \usepackage{textcomp}
@@ -159,7 +160,7 @@
 #+ATTR_LaTeX: height=7.5cm
   [[./calculator.png]]
 
-** Debug your code interactively with the solver (Unix only)
+** Debug your code interactively with the solver ([[http://www.gnu.org/gnu/why-gnu-linux.html][Gnu/Linux]])
    You can run the ANSYS solver/interpreter under Emacs and send
    code lines from the APDL window (above) with *C-c C-c* directly to
    this process. Below you get an interactive solver output window and
@@ -168,7 +169,7 @@
 #+ATTR_HTML: width="1200"
 #+ATTR_LaTeX: height=6.5cm
   [[./process.png]]
-** Display the license status and graphics (also PDF) on UNIX
+** Display the license status and graphics on Gnu/Linux
    In Emacs' mid-section you see the license state (*C-c C-l*)
    and left Emacs window (below) a thumbnail view of images from a
    folder.
@@ -177,7 +178,7 @@
 #+ATTR_HTML: width="1200"
    [[./license.png]]
 
-** Arrange the ANSYS-Mode windows to your needs \\ The image shows an Emacs 23.2 frame (in reversed colour mode and compiled with the GTK+ toolkit under Linux) with a ripped off ANSYS menu field
+** Arrange the ANSYS-Mode windows to your needs \\ The image shows an Emacs 23.2 frame (in reversed colour mode and compiled with the GTK+ toolkit under Gnu/Linux) with a ripped off ANSYS menu field
 
 # The
 # APDL file is in the right window with the (experimental) user variable
@@ -219,9 +220,9 @@
 * Documentation and Licensing
 
 ** Get to know Emacs and check out its tutorial
-  Newcomers to Emacs should take the guided [[http://www.gnu.org/software/emacs/tour/][online tour]] to get a
-  background of its capabilities and fire up the interactive tutorial
-  (*C-h t*) which is translated to various languages.
+  Newcomers to Emacs should take the excellent [[http://www.gnu.org/software/emacs/tour/][guided online tour]] to
+  get a background of its capabilities and fire up the interactive
+  tutorial (*C-h t*) which is translated to various languages.
 
 #+ATTR_LaTeX: height=7.5cm
   [[./emacs_tutorial.png]]
@@ -238,7 +239,7 @@
 
 *** Hands-on tutorial:
     You will find this more in-depth tutorial included in the mode's
-    archives on Google Code's [[http://code.google.com/p/ansys-mode/downloads/list][download page]] or [[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/APDL_tutorial.html][online]].
+    archives on Google Code's [[http://code.google.com/p/ansys-mode/downloads/list][download page]] or [[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/A-M_in-depth_tutorial.html][online]].
 *** Installation:
     More detailed instructions are necessary if you are not using the
     mode bundled with Emacs for Windows.  Please have a look in the
@@ -291,7 +292,7 @@
 #         :BEAMER_col: 0.5
          :END:
     Solver communication/feedback - hybrid between coding and
-    debugging (UNIX only), retrieving license states, error file
+    debugging (Gnu/Linux only), retrieving license states, error file
     viewing, abort file handling, extending APDL templates, ...
 ** Last slide of the ANSYS-Mode tutorial
 ***  Hint for the curious:

README

@@ -36,15 +36,13 @@ code is partially based on ANSYS version 14.5 (completions, help
 strings etc.).  Besides the code and Emacs you will find also in the
 download section two tutorials.  For an immediate access have a look
 at the
-[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/ansys-mode_tutorial.html
-introductory on-line version], here you are able to see the images in
+[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/A-M_introductory_tutorial.html introductory on-line version], here you are able to see the images in
 a higher resolution as in the PDF version.  And in the
-[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/APDL_tutorial.html
-in-depth on-line tutorial] there is the source code highlighting
+[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/A-M_in-depth_tutorial.html in-depth on-line tutorial] there is the source code highlighting
 better preserved as in its PDF version.
 
 Please report bugs and inconsistencies also in the documentation! Write
-an email to the [mailto:dieter@duenenhof-wilhelm maintainer] or use
+an email to the [mailto:dieter@duenenhof-wilhelm.de maintainer] or use
 Google Code's [http://code.google.com/p/ansys-mode/issues/list issues list].
 
 == Requirements ==
@@ -53,7 +51,7 @@ It is tested with Emacs-24.1, Emacs-24.2 under XP64 and under
 GNU/Linux64 (here also with Emacs-23.2).
 
 Some of ANSYS-Mode's solver control and communication features are
-only implemented for UNIX systems.
+only implemented for Gnu/Linux systems.
 
 == Features ==
 
@@ -71,7 +69,7 @@ only implemented for UNIX systems.
 
 * Solver comunication facilities, i. e. sending code fragments from
   the macro file or commands interactively to an ANSYS solver process
-  (UNIX only).
+  (Gnu/Linux only).
 
 * Keyword completion of ANSYS commands, elements, get- and
   parametric-functions (case-sensitive) of around 2000 ANSYS symbols.
@@ -126,13 +124,13 @@ only implemented for UNIX systems.
 == Example applications ==
 
 Visual examples you will find in the
-[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/ansys-mode_tutorial.html online tutorial]
+[http://duenenhof-wilhelm.de/dieter/ansys-mode_tutorial/A-M_introductory_tutorial.html online tutorial]
 and the following screen-shot on [http://www.emacswiki.org/emacs/AnsysMode EmacsWiki]
 
 http://www.duenenhof-wilhelm.de/dieter/ansys-mode.jpg
 
 Above image shows an Emacs frame (in reversed colour mode and compiled
-with the GTK+ toolkit under Linux) with a ripped off menu field.  The
+with the GTK+ toolkit under Gnu/Linux) with a ripped off menu field.  The
 APDL file is in the right window with the (experimental) user variable
 highlighting switched on and a help overlay (in yellow background)
 activated. The smaller windows on the left hand side are showing the
@@ -141,6 +139,62 @@ a certain code template, respectively.
 
 == News ==
 
+* Added a function (C-c C-b or "M-x ansys-browse-ansys-help") showing
+  the detailed ANSYS help in your web-browser for an APDL command or
+  element name (also the element number is sufficient) around the
+  cursor (or if that fails at the line beginning).
+
+  Are you also tired of the ANSYS help browser?  For example try
+  searching for the `F' APDL command, it is impossible!  You have to
+  pick it up from the alphabetical command list. Likewise when you are
+  searching for an incomplete keyword, no hint, no completion,
+  nothing!  Finding and browsing relevant APDL documentation is still
+  cumbersome and too slow
+
+  As a highlight of this release you can now read immeadiately the
+  detailed ANSYS help in your web browser for *all* APDL command AND
+  element names around the cursor (or for the first command in the
+  current line if that fails to be valid keyword).  You may input your
+  search string also interactively, including its completion to ANSYS
+  help keywords and of certain help categories, like `Release Notes'
+  and such. This is an ideal complement to ANSYS-Mode's in-built
+  `command syntax help'
+
+* The function `ansys-start-ansys' is now available under Windows as well
+  and starts the APDL product launcher under this platform.
+
+* When calling `ansys-browse-ansys-help' and
+  `ansys-show-command-parameters' (M-? - the in-built `command syntax
+  help') with a prefix argument for interactively entering a command
+  name, the name is now completable.  And in the non-interactive mode
+  both functions working also for APDL commands which are commented
+  out as well (only for the first command in case of
+  `ansys-show-command-parameters').
+
+* Also the input of `ansys-query-ansys-command' (C-c C-q) is now
+  completable to all current ANSYS commands and with an optional
+  prefix argument the current code line is copied as the initial
+  input.
+
+* Improved the introductory and the in-depth tutorial and extended the
+  documentation with an APDL and syntax highlighting reference in HTML
+  and PDF. (To some degree syntax highlighted in the PDF version as
+  well)
+
+* Values of the `_RETURN' variable are now documented in the function
+  `ansys-skeleton-information'
+
+* `ansys-next-code-line' and `ansys-previous-code-line' (M-n, M-p) are
+  now skipping over node and elements blocks, which are only pure
+  number blocks.  They are now alternatives to
+  `ansys-number-block-start' C-c { and C-c } respectively
+
+* Removed bug in customisation system and dropped 32 bit ANSYS support
+  in line with the ANSYS OS
+  [http://www.ansys.com/Support/Platform+Support strategy] for 2013.
+
+* Described a poor man's round() workaround in ansys-template-function
+  under the nint() entry
 
 Please have a look in the NEWS file for the complete history
 
@@ -170,10 +224,10 @@ Auxiliaries:
 * LICENSE -- The GPL (Gnu Puplic License) Version 3
 * default_el -- Configuration example file of an Emacs 'default.el'
 * fontification.mac -- APDL example file
-* A-M_introductory_tutorial.pdf -- Your first look at ANSYS-Mode?
-* A-M_in-depth_tutorial.pdf -- A hands-on ANSYS-Mode tutorial
-* A-M_in-depth_tutorial.ansys -- Hands-on tutorial's supplementary APDL code
-* A-M_APDL_reference.pdf -- APDL and ANSYS-Mode syntax highlighting reference guide
+* A-M_introductory_tutorial-14.5.1.pdf -- Your first look at ANSYS-Mode?
+* A-M_in-depth_tutorial-14.5.1.pdf -- A hands-on ANSYS-Mode tutorial
+* A-M_in-depth_tutorial-14.5.1.ansys -- Hands-on tutorial's supplementary APDL code
+* A-M_APDL_reference-14.5.1.pdf -- APDL and ANSYS-Mode syntax highlighting reference guide
 
 === Short instructions ===
 
@@ -204,7 +258,7 @@ In case you want to download or have already installed the
 can also download and configure the ANSYS-Mode package
 separately. Please see below.
 
-__For existing Emacs installations on Windows and UNIX:__
+__For existing Emacs installations on Windows and Gnu/Linux:__
 
 ==== Direct way; no file configuration necessary ====
 
@@ -307,6 +361,7 @@ explicitely called ansys-mode.
      (autoload 'ansys-abort-file "ansys-mode" "Activate the function for  aborting ANSYS runs." 'interactive)
      (autoload 'ansys-display-error-file "ansys-mode" "Activate the function for inspecting the ANSYS error file." 'interactive)
      (autoload 'ansys-start-ansys-help "ansys-mode" "Activate the function for starting the ANSYS help browser." 'interactive)
+     (autoload 'ansys-start-ansys "ansys-mode" "Activate the function for starting the APDL interpreter under Gnu/Linux or product launcher under Windows." 'interactive)
      (autoload 'ansys-license-status "ansys-mode" "Activate the function for displaying ANSYS license status or starting a license utility." 'interactive)
 
 * A further configuration method
@@ -369,7 +424,7 @@ Then in mainly reversed cronological order:
 * Eli Zaretzki
 * Markus Triska
 * Mathias Dahl
-* RMS
+* [http://stallman.org/ RMS]
 
 == Resources ==
 

TODO

@@ -11,7 +11,7 @@
                     command and is not highlighted as label
   - Highlighting :: An apostrophy clashes with the ANSYS "char"
                     specifier Keybinding: M-Tab is captured under
-                    Windows and some Linux desktops Workaround: Press
+                    Windows and some Gnu/Linux desktops Workaround: Press
                     instead of M-Tab (ALT + TAB) the ESC key and then
                     the Tab key (ESC, TAB) or apply the command from
                     the menu bar
@@ -31,7 +31,7 @@
   - Skeleton :: Mouse selection of -structural-template does not work
                 (because of stipulated user text input from this skeleton)
 
-*  14.5.1:
+*  15.0.1:
 ** TODO Freeze
    - makefile errors: Check tutorials
    - -dynamic-highlighting is sluggish, highlighting somehow
@@ -73,7 +73,19 @@
      skeleton, critical to element differences!
    - _RETURN somewhat milder red, clashes with reseved vars!
    - constraint equations in -template.el and get functions
+** Bugs
+   - mouse completion does not work in completion buffer (for
+     templates)
+   - help overlay is only removed after 1 min if the buffer is active
+      at that time
+   - mismatch in customisation buffer of -license-file and -ansysli-servers
+** Compiler warnings
+    - ansys-template.el:85:13:Warning: reference to free variable
+      `ansys-skeleton-overlay'
+    - mouse-choose-completion is obsolete since E23.2
 ** Release
+   - makefile fontification of _tutorial PDFs is not working,
+     necessary to load them by hand before exporting
    - document A-M_in-depth_tutorial.org
        - fontification.mac, leave it in the mode archive for a while
        - upload to Google code: file:googlecode_upload.py
@@ -88,25 +100,16 @@
        completable, whitespace problem befor paren...
        and: "nele" undocumented command and function nelem()
      - es not :
-       + *mwrite
-       + *cfclos
-       + *sread M-? shows help for *mwrite
+        *mwrite
+        *cfclos
+	 M-? shows help for *mwrite, when cursor behind *cfclos
    - -introductory_tutorial.org
      - update download page to 14.5.1 in the download slide
      - in variable.png symbols Ns and Ls are not highlighted as
        variables
      - change sequence of alignment.pgn first not aligned, second aligned
      - Too difficult: slide of extensibility, showing Emacs
        self-documenting help system for a template function
-** Bugs
-   - help overlay is only removed after 1 min if the buffer is active
-      at that time
-   - mismatch in customisation buffer of -license-file and -ansysli-servers
-** Compiler warnings
-    - ansys-template.el:85:13:Warning: reference to free variable
-      `ansys-skeleton-overlay'
-    - mouse-choose-completion is obsolete since E23.2
-
 * Procedures
   - Mode Help :: keyboard input is quoted in "", emphasizing in `' and
                  keys in <>
@@ -128,12 +131,12 @@
     specifiers
 
     (tags-query-replace "145" "150")
-    (tags-query-replace "24.1" "24.?")
+    (tags-query-replace "24.2" "24.?")
     (tags-query-replace "14.5" "15.0")
     (tags-query-replace "- 2012" "- 2013")
 
     checkdoc then dry run: Emacs
-    24.1 -Q testing: fontification.mac /*commands and default command
+    24.2 -Q testing: fontification.mac /*commands and default command
     lines, every menu entry.  byte-compile-file then dry run
     profiling, major mode conventions: multiple loading of this mode?.
   - check Emacs versions on longterm OS systems compile with 22.X,

ansys-fontification.el

@@ -726,7 +726,7 @@ By default Ansys keywords, get-functions, parametric-function and elements
     (insert-file-contents "ansys_Index.hlp")
     ;; clean up redundant keywords
     (delete-matching-lines "^Hlp")
-    (goto-char (point-min))
+    ;; (goto-char (point-min))	  
     ;; (delete-matching-lines "^Hlp_E_")
     ;; (goto-char (point-min))
     ;; ;; shorten keywords