Add documentation

pull/8675/merge^2
piotrkwarcinski 2025-05-11 22:58:35 +02:00
parent c0c3d69280
commit d9ec722a77
1 changed files with 40 additions and 20 deletions

View File

@ -1096,32 +1096,52 @@ fn load_editor_api(engine: &mut Engine, generate_sources: bool) {
template_function_arity_0("cx->cursor"); template_function_arity_0("cx->cursor");
template_function_arity_0("editor-focused-buffer-area"); template_function_arity_0("editor-focused-buffer-area");
let mut template_function_arity_1 = |name: &str| { let mut template_function_arity_1 = |name: &str, doc: &str| {
builtin_editor_command_module.push_str(&format!( if generate_sources {
r#" let docstring = format_docstring(doc);
builtin_editor_command_module.push_str(&format!(
r#"
(provide {}) (provide {})
;;@doc
{}
(define ({} arg) (define ({} arg)
(helix.{} *helix.cx* arg)) (helix.{} *helix.cx* arg))
"#, "#,
name, name, name name, docstring, name, name
)); ));
}
}; };
template_function_arity_1("editor->doc-id"); template_function_arity_1("editor->doc-id", "Get the document from a given view");
template_function_arity_1("editor-switch!"); template_function_arity_1("editor-switch!", "Open the document in a vertical split");
template_function_arity_1("editor-set-focus!"); template_function_arity_1("editor-set-focus!", "Set focus on the view");
template_function_arity_1("editor-set-mode!"); template_function_arity_1("editor-set-mode!", "Set the editor mode");
template_function_arity_1("editor-doc-in-view?"); template_function_arity_1(
template_function_arity_1("set-scratch-buffer-name!"); "editor-doc-in-view?",
template_function_arity_1("editor-doc-exists?"); "Check whether the current view contains a document",
template_function_arity_1("editor->text"); );
template_function_arity_1("editor-document->path"); template_function_arity_1(
template_function_arity_1("register->value"); "set-scratch-buffer-name!",
"Set the name of a scratch buffer",
);
template_function_arity_1("editor-doc-exists?", "Check if a document exists");
template_function_arity_1("editor->text", "Get the document text as a rope");
template_function_arity_1("editor-document->path", "Get the path to a document");
template_function_arity_1("register->value", "Get register value as a list of strings");
template_function_arity_1("set-editor-clip-top!"); template_function_arity_1("set-editor-clip-top!", "Set the editor clipping at the top");
template_function_arity_1("set-editor-clip-right!"); template_function_arity_1(
template_function_arity_1("set-editor-clip-left!"); "set-editor-clip-right!",
template_function_arity_1("set-editor-clip-bottom!"); "Set the editor clipping at the right",
);
template_function_arity_1(
"set-editor-clip-left!",
"Set the editor clipping at the left",
);
template_function_arity_1(
"set-editor-clip-bottom!",
"Set the editor clipping at the bottom",
);
let mut template_function_arity_2 = |name: &str| { let mut template_function_arity_2 = |name: &str| {
builtin_editor_command_module.push_str(&format!( builtin_editor_command_module.push_str(&format!(