Merge branch 'feature/ivette/emacs' into 'master'

[ivette] refactoring main documentation

See merge request frama-c/frama-c!2657

ivette/CONTRIBUTING.md

+## Coding Guidelines
+
+- use `make app` (checked by GitLab-CI)
+- per-directory `style.css` for CSS;
+- caml-cased file names for typescript modules;
+- indentation based on 2 spaces, no tabs;
+- caml-case identifiers for exported members;
+- no `export default` for libs, individual exports only;
+- prefer use of `import * as AbcDef from '<path>/AbcDef'`;
+
+## Makefile Targets
+
+From the `./ivette` sub-directory of Frama-C main directory:
+
+```
+$ make app  // Builds desktop app
+$ make dev  // Launch development version with live code editing
+$ make doc  // Generate development documentation (static)
+$ make serve // Serve the documentation (makes it searchable)
+```
+
+Once build, the application can be launched from the command line
+with `./bin/frama-c-gui`.
+
+The static documentation is available offline at `doc/html/index.html`.
+However, searching the documentation does not work
+with `file://` protocole, use `make serve` to use it.
+
+## Mirroring to Dome/Electron
+
+**Warning:** not recommanded until all codebase has been moved to TypeScript.
+
+The content of ./src/dome shall be kept in sync with
+the public repository for Dome. An experimental support
+for automated synchronisation is available with:
+- `make dome-pull` for pulling Dome updates into Ivette
+- `make dome-push` for pushing local updates into Dome

ivette/INSTALL.md

+# Installation
+
+Required package to be installed:
+- `yarn` for node and node pakage management;
+- `pandoc` for generating the documentation;
+
+# Emacs Configuration
+
+Emacs mode configuration can be setup with Typescript, Web-mode and Tide packages.
+You can install them with `M-x package-install`:
+
+```
+M-x package-refresh-contents ;; updates your index
+M-x package-install web-mode
+M-x package-install typescript-mode
+M-x package-install tidse
+```
+
+For configuring your `.emacs` accordingly,
+please look at the `share/typescript-config.el` file.
+It setup the Tide package to work with
+`typescript-mode` for `*.ts` files (see also `tsfmt.json` config file)
+and `web-mode` for `*.tsx` files.
+
+Usefull commands:
+
+```
+M-. goto definition
+M-, back to previous point
+M-x tide-documentation-at-point
+M-x tide-error-at-point
+```
+
+# VS Code
+
+VS Code has native support for Typescript (and JavaScript, of course), in terms
+of code navigation, syntax highlighting and formatting, compiler errors and
+warnings. The same holds for React development.
+
+Useful extensions:
+- `ESlint` provides support for lint errors and warnings;
+- `ES7 React/Redux/GraphQL/React-Native snippets` provides boilerplate snippets;

ivette/README.md

-## Dome Framework Guides
+## Ivette
+
+Main entry points:
+- [frama-c/server](modules/frama_c_server.html) Frama-C Server interaction (low level)
+- [frama-c/states](modules/frama_c_states.html) high-level request management
+
+## Command Line
+
+The following options are recognized by `./bin/frama-c-gui`:
+
+- `--cwd` working directory of Frama-C server
+- `--command` path to Frama-C binary
+- `--socket` ZeroMQ socket address of the server
+
+The default working directory is the current one.
+The default command is the local `bin/frama-c` of source installation.
+The default socket is `ipc:///.frama-c.<pid>.io`.
+
+## Dome Guides
 
 - [Dome Framework](guides/dome.md.html)
 - [Quick Start](guides/quickstart.md.html)
@@ -9,39 +27,3 @@
 - [Custom Hooks](guides/hooks.md.html)
 - [Icon Gallery](guides/icons.md.html)
 - [Glossary](guides/glossary.md.html)
-
-## Setup
-
-From the `./ivette` sub-directory of Frama-C main directory:
-
-```
-$ make app
-```
-
-## Typescript Editors
-
-Emacs mode configuration can be setup with Typescript, Web-mode and Tide packages
-which are all available with MELPA. For configuring your `.emacs` accordingly,
-please look at the `share/typescript-config.el` file.
-This setup the Tide package to work with
-`typescript-mode` for `*.ts` files (see also `tsfmt.json` config file)
-and `web-mode` for `*.tsx` files.
-
-VS-Code is also known to work out of the box.
-
-## Coding Guidelines
-
-- per-directory `style.css` for CSS;
-- caml-cased file names for typescript modules;
-- indentation based on 2 spaces, no tabs;
-- caml-case identifiers for exported members;
-- no `export default` for libs, individual exports only;
-- prefer use of `import * as AbcDef from '<path>/AbcDef'`;
-
-## Mirroring to Dome/Electron
-
-The content of ./src/dome shall be kept in sync with
-the public repository for Dome. An experimental support
-for automated synchronisation is available with:
-- `make dome-pull` for pulling Dome updates into Ivette
-- `make dome-push` for pushing local updates into Dome

ivette/jsdoc.json

-{
-  "source": {
-    "include": [
-      "src/dome/doc/README.md",
-      "build"
-    ]
-  },
-  "opts": {
-    "recurse": true,
-    "tutorials": "src/dome/doc/tutorials",
-    "template": "src/dome/doc/template"
-  },
-  "plugins": [ "plugins/markdown" ],
-  "templates": {
-    "default": {
-      "useLongnameInNav": true,
-      "outputSourceFiles": false,
-      "includeDate": false
-    }
-  }
-}

ivette/share/typescript-config.el

@@ -19,6 +19,7 @@
 (defun setup-txs-mode ()
   (interactive)
   (when (string-equal "tsx" (file-name-extension buffer-file-name))
+    (setq web-mode-enable-auto-quoting nil)
     (setup-tide-mode)))
 
 ;; aligns annotation to the right hand side