Add defconst -mode-update

apdl-initialise.el

@@ -1,5 +1,5 @@
 ;;; apdl-initialise.el --- Initialisation code for APDL-Mode -*- lexical-binding: t -*-
-;; Time-stamp: <2020-03-26>
+;; Time-stamp: <2020-04-01>
 
 ;; Copyright (C) 2016 - 2020  H. Dieter Wilhelm
 
@@ -39,10 +39,16 @@
 (defconst apdl-mode-version "20.4.0"
   "The APDL-Mode version string.")
 
+(defconst apdl-mode-update "2020-04-01"
+  "APDL-Mode packaging date string in yyyy-mm-dd format.
+This is for the APDL-Mode development versions to check the time
+of packaging.")
+
 (defconst apdl-mode-install-directory
   (file-name-directory (locate-library "apdl-mode"))
-  "The installation directory of APDL-Mode.
-A string describing the directory where the Elisp files reside.")
+  "The installation directory string of APDL-Mode.
+The string contains the directory where the APDL-Mode Elisp files
+reside.")
 
 (defconst apdl-ansys-version "v201"
   "Ansys version string on which APDL-Mode is based upon.

apdl-mode.el

@@ -1,5 +1,5 @@
 ;;; apdl-mode.el --- Major mode for the scripting language APDL -*- lexical-binding: t -*-
-;; Time-stamp: <2020-03-31>
+;; Time-stamp: <2020-04-01>
 
 ;; Copyright (C) 2006 - 2020  H. Dieter Wilhelm GPL V3
 
@@ -1540,8 +1540,20 @@ and P-MAX) otherwise align the current code paragraph."
 
 ;;;###autoload
 (defun apdl-mode ()
-  "Editor support for the APDL language and working with Ansys FEA.
-Help in Info format `apdl-mode-help'.
+  "Editor support for the APDL language and working with Ansys MAPDL.
+
+APDL-Mode (formerly Ansys-Mode) is - in conjunction with the
+GNU-Emacs editor - an advanced APDL environment with features
+like, pin-pointing the APDL reference documentation, keyword
+completion, code templates, dedicated highlighting, solver
+communication (GNU-Linux only), license reporting, etc.  Over the
+years it has accumulated lots of features for writing WorkBench /
+Discovery AIM Command (APDL) objects and debugging complete FEA
+models in APDL code.
+
+The extensive documentation can be accessed from the APDL-Mode
+menu or by calling the function `apdl-mode-help' with
+\\[apdl-mode-help].
 
 \\{apdl-mode-map}"
   (interactive)
@@ -1813,10 +1825,13 @@ Arg ALLOW-EXTEND is in interactive calls the same as ARG."
          (forward-paragraph arg))))
 
 (defun apdl-mode-version ()
-  "Display the APDL-Mode version numbering scheme."
+  "Display the APDL-Mode version numbering scheme.
+Together with the APDL-Mode update date and the Ansys version on
+which the keyword- and completion system is based upon."
   (interactive)
-  (message "APDL-Mode version: %s (based on Ansys %s)"
+  (message "APDL-Mode version: %s (%s) (based on Ansys %s)"
            apdl-mode-version
+	   apdl-mode-update
            apdl-ansys-version))
 
 
@@ -3000,6 +3015,9 @@ These constructs appear in WorkBench created solver input files."
        (list
         ;; constants
         'apdl-mode-version
+	'apdl-mode-update
+	'apdl-mode-install-directory
+	;; 'apdl-ansys-version ; is in -ansys-install-directory included
 	;; variables
 	'apdl-initialised-flag
 	'apdl-current-ansys-version

apdl-mode.info

@@ -3040,7 +3040,7 @@ File: apdl-mode.info,  Node: Version 2040 1,  Next: Version 2030 1,  Prev: Versi
 12.2 *TODO* Version 20.4.0
 ==========================
 
-updated to 2020R1
+updated to 2020R1 freeze: _[2020-04-01 Wed]_
 
 * Menu:
 
@@ -3057,10 +3057,6 @@ File: apdl-mode.info,  Node: Todos bugs,  Next: minor bugs,  Up: Version 2040 1
 12.2.1 Todos, bugs
 ------------------
 
-   • apdl-start-ansys (make-comint) - doesn’t start the launcher under
-     windows
-   • apdl-start-classics (start-process) -
-
 * Menu:
 
 * State of documentation::
@@ -3092,63 +3088,13 @@ File: apdl-mode.info,  Node: State of documentation,  Up: Todos bugs
      steps:
    • add intro to the wb-template system
    • explain interactive browsing of keywords => menu entry
-   • shift org-files to doc or info, except README.org: Focus: Intro +
-     Features + Installation
-        • usage
-        • config
-   • orgs
-        • install
-        • news
-        • todo
-        • config
-        • index
-   • tutorials
-        • -intro-tut
-        • -apdl-reference
-        • -in-depth_tutorial
-   • combine apdl-mode help, tutorial, usage, customisation
-        • tutorial
-        • bugs
-   • find nice style css stuff for html export?
-
-   Focus: Marketing and get it going, then details help + templates
-
    • Presentations
         • Präsentation Intro, tutorial
         • in-dept present.
         • APDL reference
 
-   • README.org
-        • Intro
-        • Highlights, features
-        • Installation
-        • Short Usage / tutorial
-        • Configuration
-        • Bugs / problems
-        • Resources
-        • GNU GPL License
-        • Acknowledgments
-        • TODOs
-
-   • info (with or without image?)
-        • First steps / tutorial <-> short usage
-        • in-dept usage <-> in-dept presentation?u
-        • copying, do we need it really?
-        • config OK consolidate tangle org
-        • Usage / applications
-             • templates
-        • APDL reference OK
-        • news OK
-        • Resources OK
-        • Bugs and Problems
-        • GNU FDL License
-        • todo OK
-        • index?
-
    • Mode help, done :-)
         • short intro general description
-        • reference / link!  to info!!!!  ;-)
-        • keybindings, that is special
 
 
 File: apdl-mode.info,  Node: minor bugs,  Next: check,  Prev: Todos bugs,  Up: Version 2040 1
@@ -3167,6 +3113,9 @@ File: apdl-mode.info,  Node: check,  Next: wishes,  Prev: minor bugs,  Up: Versi
 12.2.3 check
 ------------
 
+   • apdl-start-ansys (make-comint) - doesn’t start the launcher under
+     windows, but is redundant with -start-classics
+   • apdl-start-classics (start-process)
    • changed file size without warning to 30 MB what is Emacs-26 using?
 
 
@@ -3219,11 +3168,13 @@ File: apdl-mode.info,  Node: Release proceedures,  Prev: Done,  Up: Version 2040
 
    • NEWS.org
    • README.org News
+   • TODO.org
+   • make PACK!
 
    gca = git commit -a = gau + gc gta = git tag -a 20.4.0
 
-   Attention: in apdl_keywords.txt there are many trailing whitespaces
-(delete-trailing-whitespace)
+   Ansys update: Attention: in apdl_keywords.txt there are many trailing
+whitespaces (delete-trailing-whitespace)
 
    whitespace-mode package-lint checkdoc, flycheck etc.  : from
 makefile?
@@ -4436,37 +4387,37 @@ Node: Other APDL editor resources125065
 Node: Todos125979
 Node: Version 2050 ?126317
 Node: Version 2040 1126444
-Node: Todos bugs126730
-Node: State of documentation127023
-Node: minor bugs129718
-Node: check130085
-Node: wishes130280
-Node: templates130429
-Node: misc130764
-Node: Done131196
-Node: Release proceedures131322
-Node: Version 2030 1131993
-Node: Version 2020 1132213
-Node: Version 2011 1132393
-Node: Version 162-2132865
-Node: Bugs133143
-Node: Freeze134112
-Node: Wish-list134469
-Node: Deficiencies140585
-Node: Procedures142246
-Node: Freeze proceedures142768
-Node: Release144295
-Node: Ideas for further versions144898
-Node: Parameter help and documentation145329
-Node: Ansys process and interpreter buffer147631
-Node: Skeletons outline and abbrevs150494
-Node: Miscellaneous 1152226
-Node: Ansys syntax restrictions not (yet) accounted for157216
-Node: Unknown Ansys stuff158119
-Node: Acknowledgements158402
-Node: GNU Free Documentation License158972
-Node: Variable Index183998
-Node: Concept Index184147
+Node: Todos bugs126757
+Node: State of documentation126916
+Node: minor bugs128219
+Node: check128586
+Node: wishes128951
+Node: templates129100
+Node: misc129435
+Node: Done129867
+Node: Release proceedures129993
+Node: Version 2030 1130712
+Node: Version 2020 1130932
+Node: Version 2011 1131112
+Node: Version 162-2131584
+Node: Bugs131862
+Node: Freeze132831
+Node: Wish-list133188
+Node: Deficiencies139304
+Node: Procedures140965
+Node: Freeze proceedures141487
+Node: Release143014
+Node: Ideas for further versions143617
+Node: Parameter help and documentation144048
+Node: Ansys process and interpreter buffer146350
+Node: Skeletons outline and abbrevs149213
+Node: Miscellaneous 1150945
+Node: Ansys syntax restrictions not (yet) accounted for155935
+Node: Unknown Ansys stuff156838
+Node: Acknowledgements157121
+Node: GNU Free Documentation License157691
+Node: Variable Index182717
+Node: Concept Index182866
 
 End Tag Table
 

helper/makefile

@@ -231,8 +231,11 @@ $(PACKAGE) : $(PACKAGE_FILES) makefile
 	@test -d $(P_DIR)/template || \
 	    mkdir $(P_DIR)/template
 	@cp -rf $(TEMPLATE) $(P_DIR)
-	tar -cf $@ $(P_DIR) # ../apdl-mode-readme.txt # default.el
-	rm -r $(P_DIR)
+	@tar -cf $@ $(P_DIR) # ../apdl-mode-readme.txt # default.el
+	@rm -r $(P_DIR)
+#       update time in -initialise.el apdl-mode-update in iso 8601 -I
+	@echo Time of packaging: `date -I`
+	@sed -i "s/(defconst apdl-mode-update \".*\"/(defconst apdl-mode-update \"`date -I`\"/" ../apdl-initialise.el
 	@echo
 	@echo "... $@ done."
 	@echo "------------------------------"