mirror of
https://github.com/Myzel394/config-lsp.git
synced 2025-06-19 15:35:28 +02:00
chore(sshd_config): Add some documentation
This commit is contained in:
parent
9ed983bf81
commit
99339f3edd
6
handlers/sshd_config/README.md
Normal file
6
handlers/sshd_config/README.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
# /sshd_config
|
||||||
|
|
||||||
|
This is the root directory for each of the handlers.
|
||||||
|
This folder should only contain the antlr grammar file,
|
||||||
|
shared libraries, variables, etc. and folders for each
|
||||||
|
logic part.
|
3
handlers/sshd_config/analyzer/README.md
Normal file
3
handlers/sshd_config/analyzer/README.md
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
# /sshd_config/analyzer
|
||||||
|
|
||||||
|
This folder analyzes the config file and returns errors, warnings, and suggestions.
|
16
handlers/sshd_config/ast/README.md
Normal file
16
handlers/sshd_config/ast/README.md
Normal file
@ -0,0 +1,16 @@
|
|||||||
|
# /sshd_config/ast
|
||||||
|
|
||||||
|
This folder contains the AST (Abstract Syntax Tree) for the handlers.
|
||||||
|
The AST is defined in a filename that's the same as the handler's name.
|
||||||
|
|
||||||
|
Each AST node must extend the following fields:
|
||||||
|
|
||||||
|
```go
|
||||||
|
type ASTNode struct {
|
||||||
|
common.LocationRange
|
||||||
|
Value commonparser.ParsedString
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Each node should use a shared prefix for the node name,
|
||||||
|
e.g. `SSHDConfig`, `SSDKey` for the `sshd_config` handler.
|
7
handlers/sshd_config/fields/README.md
Normal file
7
handlers/sshd_config/fields/README.md
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
# /sshd_config/fields
|
||||||
|
|
||||||
|
This folder contains the glue between the config documentation and
|
||||||
|
our language server.
|
||||||
|
|
||||||
|
`fields.go` usually contains a list of all the available options / fields
|
||||||
|
the config file offers.
|
5
handlers/sshd_config/handlers/README.md
Normal file
5
handlers/sshd_config/handlers/README.md
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# /sshd_config/handlers
|
||||||
|
|
||||||
|
This folder contains the actual logic for the LSP commands.
|
||||||
|
Stuff like fetching completions, executing commands, getting hover
|
||||||
|
definitions, etc. should be done here.
|
9
handlers/sshd_config/indexes/README.md
Normal file
9
handlers/sshd_config/indexes/README.md
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
# /sshd_config/indexers
|
||||||
|
|
||||||
|
This folder contains logic for indexing the AST.
|
||||||
|
|
||||||
|
Creating the indexer fulfills two purposes:
|
||||||
|
* Creating actual indexes
|
||||||
|
* Validating some logic
|
||||||
|
|
||||||
|
The indexer also validates stuff like checking for duplicate values, etc.
|
7
handlers/sshd_config/lsp/README.md
Normal file
7
handlers/sshd_config/lsp/README.md
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
# /sshd_config/lsp
|
||||||
|
|
||||||
|
This folder is the glue between our language server and the LSP
|
||||||
|
clients.
|
||||||
|
This folder only contains LSP commands.
|
||||||
|
It only handles very little actual logic, and instead calls
|
||||||
|
the handlers from `../handlers`.
|
Loading…
x
Reference in New Issue
Block a user