1
0
mirror of https://github.com/weechat/weechat.git synced 2026-07-03 16:23:14 +02:00

doc: sort directories and files, reformat emacs lisp example in developer's guide

This commit is contained in:
Sébastien Helleu
2015-05-17 07:48:21 +02:00
parent fd3b3d6711
commit 1fb3e8b2dc
3 changed files with 69 additions and 66 deletions
+25 -24
View File
@@ -70,17 +70,17 @@ The main WeeChat directories are:
| charset/ | Charset plugin
| exec/ | Exec plugin
| fifo/ | Fifo plugin (FIFO pipe used to remotely send commands to WeeChat)
| irc/ | IRC (Internet Relay Chat) plugin
| logger/ | Logger plugin (write messages displayed to files)
| relay/ | Relay plugin (irc proxy + relay for remote interfaces)
| script/ | Scripts manager
| python/ | Python scripting API
| perl/ | Perl scripting API
| ruby/ | Ruby scripting API
| lua/ | Lua scripting API
| tcl/ | Tcl scripting API
| guile/ | Guile (scheme) scripting API
| irc/ | IRC (Internet Relay Chat) plugin
| javascript/ | Javascript scripting API
| logger/ | Logger plugin (write messages displayed to files)
| lua/ | Lua scripting API
| perl/ | Perl scripting API
| python/ | Python scripting API
| relay/ | Relay plugin (irc proxy + relay for remote interfaces)
| ruby/ | Ruby scripting API
| script/ | Scripts manager
| tcl/ | Tcl scripting API
| trigger/ | Trigger plugin
| xfer/ | Xfer plugin (IRC DCC file/chat)
| tests/ | Tests
@@ -106,7 +106,6 @@ WeeChat "core" is located in following directories:
|===
| Path/file | Description
| core/ | Core functions: entry point, internal structures
| weechat.c | Main functions: command line options, startup
| wee-arraylist.c | Array lists
| wee-backtrace.c | Display a backtrace after a crash
| wee-command.c | WeeChat core commands
@@ -132,6 +131,7 @@ WeeChat "core" is located in following directories:
| wee-utf8.c | UTF-8 functions
| wee-util.c | Some other functions
| wee-version.c | Functions for WeeChat version
| weechat.c | Main functions: command line options, startup
| gui/ | Functions for buffers, windows, ... (used by all interfaces)
| gui-bar-item.c | Bar items
| gui-bar-window.c | Bar windows
@@ -339,16 +339,16 @@ Documentation files:
| asciidoc.css | Asciidoc style
| docgen.py | Python script to build files in 'autogen/' directory (see below)
| XX/ | Documentation for language XX (languages: en, fr, de, it, ...)
| cmdline_options.XX.asciidoc | Command-line options (file included in man page and user's guide)
| weechat.1.XX.asciidoc | Man page (`man weechat`)
| weechat_quickstart.XX.asciidoc | Quickstart guide
| weechat_user.XX.asciidoc | User's guide
| weechat_dev.XX.asciidoc | Developer's guide (this document)
| weechat_faq.XX.asciidoc | FAQ
| weechat_plugin_api.XX.asciidoc | Plugin API reference
| weechat_quickstart.XX.asciidoc | Quickstart guide
| weechat_relay_protocol.XX.asciidoc | Relay protocol (for remote interfaces)
| weechat_scripting.XX.asciidoc | Scripting guide
| weechat_tester.XX.asciidoc | Tester's guide
| weechat_dev.XX.asciidoc | Developer's guide (this document)
| weechat_relay_protocol.XX.asciidoc | Relay protocol (for remote interfaces)
| cmdline_options.XX.asciidoc | Command-line options (file included in man page and user's guide)
| weechat_user.XX.asciidoc | User's guide
| autogen/ | Files auto-built with script docgen.py
| user/ | Files auto-built for user's guide (do *NEVER* update manually!)
| plugin_api/ | Files auto-built for plugin API (do *NEVER* update manually!)
@@ -590,12 +590,13 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[source,lisp]
----
(add-hook 'c-mode-common-hook '(lambda ()
(c-toggle-hungry-state t)
(c-set-style "k&r")
(setq c-basic-offset 4
c-tab-always-indent t)
(c-set-offset 'case-label '+)))
(add-hook 'c-mode-common-hook
'(lambda ()
(c-toggle-hungry-state t)
(c-set-style "k&r")
(setq c-basic-offset 4)
(c-tab-always-indent t)
(c-set-offset 'case-label '+)))
----
[[coding_python_style]]
@@ -964,9 +965,9 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
Git repository is at this URL: https://github.com/weechat/weechat
Any patch for bug or new feature must be done on master branch, preferred way is
a GitHub pull request. A patch can also be sent by e-mail (made with `git diff`
or `git format-patch`).
Any patch for bug or new feature must be done on master branch, preferred way
is a GitHub pull request. A patch can also be sent by e-mail
(made with `git diff` or `git format-patch`).
Format of commit message is the following (to close a GitHub issue):
+22 -21
View File
@@ -71,17 +71,17 @@ Les répertoires principaux de WeeChat sont :
| charset/ | Extension Charset
| exec/ | Extension Exec
| fifo/ | Extension Fifo (tube FIFO utilisé pour envoyer des commandes à WeeChat)
| irc/ | Extension IRC (Internet Relay Chat)
| logger/ | Extension Logger (enregistrer les messages affichés dans des fichiers)
| relay/ | Extension Relay (proxy IRC + relai pour interfaces distantes)
| script/ | Gestionnaire de scripts
| python/ | API script Python
| perl/ | API script Perl
| ruby/ | API script Ruby
| lua/ | API script Lua
| tcl/ | API script Tcl
| guile/ | API script Guile (scheme)
| irc/ | Extension IRC (Internet Relay Chat)
| javascript/ | API script Javascript
| logger/ | Extension Logger (enregistrer les messages affichés dans des fichiers)
| lua/ | API script Lua
| perl/ | API script Perl
| python/ | API script Python
| relay/ | Extension Relay (proxy IRC + relai pour interfaces distantes)
| ruby/ | API script Ruby
| script/ | Gestionnaire de scripts
| tcl/ | API script Tcl
| trigger/ | Extension Trigger
| xfer/ | Extension Xfer (IRC DCC fichier/discussion)
| tests/ | Tests
@@ -107,7 +107,6 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|===
| Chemin/fichier | Description
| core/ | Fonctions du cœur : point d'entrée, structures internes
| weechat.c | Fonctions principales : options de ligne de commande, démarrage
| wee-arraylist.c | Listes avec tableau (« arraylists »)
| wee-backtrace.c | Afficher une trace après un plantage
| wee-command.c | Commandes du cœur de WeeChat
@@ -133,6 +132,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
| wee-utf8.c | Fonctions UTF-8
| wee-util.c | Quelques autres fonctions utilitaires
| wee-version.c | Fonctions pour la version de WeeChat
| weechat.c | Fonctions principales : options de ligne de commande, démarrage
| gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces)
| gui-bar-item.c | Objets de barre
| gui-bar-window.c | Fenêtres de barre
@@ -340,16 +340,16 @@ Fichiers de documentation :
| asciidoc.css | Style Asciidoc
| docgen.py | Script Python pour construire les fichiers dans le répertoire 'autogen/' (voir ci-dessous)
| XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...)
| cmdline_options.XX.asciidoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur)
| weechat.1.XX.asciidoc | Page de manuel (`man weechat`)
| weechat_quickstart.XX.asciidoc | Guide demarrage
| weechat_user.XX.asciidoc | Guide utilisateur
| weechat_dev.XX.asciidoc | Guide duveloppeur (ce document)
| weechat_faq.XX.asciidoc | FAQ (questions fréquemment posées)
| weechat_plugin_api.XX.asciidoc | Référence API extension
| weechat_quickstart.XX.asciidoc | Guide de démarrage
| weechat_relay_protocol.XX.asciidoc | Protocole Relay (pour les interfaces distantes)
| weechat_scripting.XX.asciidoc | Guide pour scripts
| weechat_tester.XX.asciidoc | Guide du testeur
| weechat_dev.XX.asciidoc | Guide du développeur (ce document)
| weechat_relay_protocol.XX.asciidoc | Protocole Relay (pour les interfaces distantes)
| cmdline_options.XX.asciidoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur)
| weechat_user.XX.asciidoc | Guide utilisateur
| autogen/ | Fichiers automatiquement générés avec le script docgen.py
| user/ | Fichiers automatiquement générés pour le guide utilisateur (ne *JAMAIS* les mettre à jour manuellement !)
| plugin_api/ | Fichiers automatiquement générés pour l'API extension (ne *JAMAIS* les mettre à jour manuellement !)
@@ -600,12 +600,13 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[source,lisp]
----
(add-hook 'c-mode-common-hook '(lambda ()
(c-toggle-hungry-state t)
(c-set-style "k&r")
(setq c-basic-offset 4
c-tab-always-indent t)
(c-set-offset 'case-label '+)))
(add-hook 'c-mode-common-hook
'(lambda ()
(c-toggle-hungry-state t)
(c-set-style "k&r")
(setq c-basic-offset 4)
(c-tab-always-indent t)
(c-set-offset 'case-label '+)))
----
[[coding_python_style]]
+22 -21
View File
@@ -80,17 +80,17 @@ This manual documents only 'weechat' repository.
| charset/ | charset プラグイン
| exec/ | exec プラグイン
| fifo/ | fifo プラグイン (WeeChat にコマンドを送信する FIFO パイプ)
| irc/ | IRC (Internet Relay Chat) プラグイン
| logger/ | logger プラグイン (表示されたメッセージをファイルに書き込む)
| relay/ | relay プラグイン (irc プロキシ + リモートインターフェイス用の中継)
| script/ | スクリプトマネージャ
| python/ | python スクリプト用 API
| perl/ | perl スクリプト用 API
| ruby/ | ruby スクリプト用 API
| lua/ | lua スクリプト用 API
| tcl/ | tcl スクリプト用 API
| guile/ | guile (scheme) スクリプト用 API
| irc/ | IRC (Internet Relay Chat) プラグイン
| javascript/ | javascript スクリプト用 API
| logger/ | logger プラグイン (表示されたメッセージをファイルに書き込む)
| lua/ | lua スクリプト用 API
| perl/ | perl スクリプト用 API
| python/ | python スクリプト用 API
| relay/ | relay プラグイン (irc プロキシ + リモートインターフェイス用の中継)
| ruby/ | ruby スクリプト用 API
| script/ | スクリプトマネージャ
| tcl/ | tcl スクリプト用 API
| trigger/ | trigger プラグイン
| xfer/ | xfer (IRC DCC ファイル/チャット)
| tests/ | テスト
@@ -116,7 +116,6 @@ WeeChat "core" は以下のディレクトリに配置されています:
|===
| パス/ファイル名 | 説明
| core/ | コア関数: エントリポイント、内部構造体
| weechat.c | 主要関数: コマンドラインオプション、起動
| wee-arraylist.c | 配列リスト
| wee-backtrace.c | クラッシュした際にバックトレースを表示
| wee-command.c | WeeChat コアコマンド
@@ -142,6 +141,7 @@ WeeChat "core" は以下のディレクトリに配置されています:
| wee-utf8.c | UTF-8 関数
| wee-util.c | その他の関数
| wee-version.c | WeeChat バージョンについての関数
| weechat.c | 主要関数: コマンドラインオプション、起動
| gui/ | バッファ、ウィンドウなどの関数 (全てのインターフェイスで利用)
| gui-bar-item.c | バー要素
| gui-bar-window.c | バーウィンドウ
@@ -349,16 +349,16 @@ WeeChat "core" は以下のディレクトリに配置されています:
| asciidoc.css | asciidoc スタイル
| docgen.py | 'autogen/' ディレクトリ内のファイルを作成する Python スクリプト (以下を参照)
| XX/ | 言語コード XX (言語コード: en、fr、de、it、...) 用のディレクトリ
| cmdline_options.XX.asciidoc | コマンドラインオプション (man ページとユーザガイドに含まれるファイル)
| weechat.1.XX.asciidoc | man ページ (`man weechat`)
| weechat_quickstart.XX.asciidoc | クイックスタートガイド
| weechat_user.XX.asciidoc | ユーザーガイド
| weechat_dev.XX.asciidoc | 開発者リファレンス (この文書)
| weechat_faq.XX.asciidoc | FAQ
| weechat_plugin_api.XX.asciidoc | プラグイン API リファレンス
| weechat_quickstart.XX.asciidoc | クイックスタートガイド
| weechat_relay_protocol.XX.asciidoc | リレープロトコル (リモートインターフェイス用)
| weechat_scripting.XX.asciidoc | スクリプト作成ガイド
| weechat_tester.XX.asciidoc | テスターガイド
| weechat_dev.XX.asciidoc | 開発者リファレンス (この文書)
| weechat_relay_protocol.XX.asciidoc | リレープロトコル (リモートインターフェイス用)
| cmdline_options.XX.asciidoc | コマンドラインオプション (man ページとユーザガイドに含まれるファイル)
| weechat_user.XX.asciidoc | ユーザーガイド
| autogen/ | docgen.py スクリプトが自動生成するファイル
| user/ | ユーザーガイド用の自動生成ファイル (手作業による編集は*禁止* !)
| plugin_api/ | プラグイン API 用の自動生成ファイル (手作業による編集は*禁止* !)
@@ -596,12 +596,13 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[source,lisp]
----
(add-hook 'c-mode-common-hook '(lambda ()
(c-toggle-hungry-state t)
(c-set-style "k&r")
(setq c-basic-offset 4
c-tab-always-indent t)
(c-set-offset 'case-label '+)))
(add-hook 'c-mode-common-hook
'(lambda ()
(c-toggle-hungry-state t)
(c-set-style "k&r")
(setq c-basic-offset 4)
(c-tab-always-indent t)
(c-set-offset 'case-label '+)))
----
[[coding_python_style]]