language tags not stripped in repl :doc #225

New issue

Closed

opened 2024-04-05 20:37:15 +00:00 by pennae · 1 comment

pennae commented

2024-04-05 20:37:15 +00:00

Owner

:doc does not strip language tags when rendering code blocks, leading to stuff like this:

❯ nix repl
Lix 2.90.0-lixpre20240328-47b0967
Type :? for help.
nix-repl> :doc builtins.parseFlakeRef
Synopsis: builtins.parseFlakeRef flake-ref

    Parse a flake reference, and return its exploded form.

    For example: nix builtins.parseFlakeRef "github:NixOS/nixpkgs/23.05?dir=lib"  evaluates to: nix { dir = "lib"; owner = "NixOS"; ref = "23.05"; repo = "nixpkgs"; type = "github"; }

note the extra nix in the explained result set that is the language tag in the inline md document the docs are rendered from.

`:doc` does not strip language tags when rendering code blocks, leading to stuff like this: ``` ❯ nix repl Lix 2.90.0-lixpre20240328-47b0967 Type :? for help. nix-repl> :doc builtins.parseFlakeRef Synopsis: builtins.parseFlakeRef flake-ref Parse a flake reference, and return its exploded form. For example: nix builtins.parseFlakeRef "github:NixOS/nixpkgs/23.05?dir=lib" evaluates to: nix { dir = "lib"; owner = "NixOS"; ref = "23.05"; repo = "nixpkgs"; type = "github"; } ``` note the extra `nix` in the explained result set that is the language tag in the inline md document the docs are rendered from.