<![CDATA[Dev1 Galaxy Forum / [HowTo] Markdown (ronn) to man]]> https://dev1galaxy.org/viewtopic.php?id=7645 Mon, 08 Dec 2025 18:03:22 +0000 FluxBB <![CDATA[Re: [HowTo] Markdown (ronn) to man]]> https://dev1galaxy.org/viewtopic.php?pid=60439#p60439 i have hand written manpages by hand for scripts that aren't even 500 lines of code long and that is because i have not generalized redundant code into functions enough like for this systemact script https://github.com/eylles/systemact which as far as i know i'm the only user and i don't even use like half of the features i've added...

]]> Mon, 08 Dec 2025 18:03:22 +0000 https://dev1galaxy.org/viewtopic.php?pid=60439#p60439 <![CDATA[Re: [HowTo] Markdown (ronn) to man]]> https://dev1galaxy.org/viewtopic.php?pid=60438#p60438 wait...you guys are adding man pages to stuff?

]]> Mon, 08 Dec 2025 17:55:43 +0000 https://dev1galaxy.org/viewtopic.php?pid=60438#p60438 <![CDATA[Re: [HowTo] Markdown (ronn) to man]]> https://dev1galaxy.org/viewtopic.php?pid=60435#p60435 but where is the fun of writing manpages by hand and having formatting not work cuz you typed one extra char after the macro?

]]> Mon, 08 Dec 2025 13:36:13 +0000 https://dev1galaxy.org/viewtopic.php?pid=60435#p60435 <![CDATA[Re: [HowTo] Markdown (ronn) to man]]> https://dev1galaxy.org/viewtopic.php?pid=60425#p60425 I prefer asciidoctor

]]> Mon, 08 Dec 2025 01:09:49 +0000 https://dev1galaxy.org/viewtopic.php?pid=60425#p60425 <![CDATA[[HowTo] Markdown (ronn) to man]]> https://dev1galaxy.org/viewtopic.php?pid=60391#p60391 ronn is a Markdown-like format for writing man pages. It's readable and editable in any text editor.

To enable syntax highlighting for .ronn files in VSCodium:

  1. Open the .ronn file.

  2. Click on "Plain Text" in the bottom-right corner of the status bar.

  3. Select "Markdown" from the language list.

This applies Markdown highlighting, which works well for .ronn files.
Alternatively, use the command palette: 
Ctrl+Shift+P → "Change Language Mode" → "Markdown".

To convert .ronn files to man format, use the ronn utility available in Devuan repositories:

$ apt-cache search ronn$
ronn - tool to build manuals from Markdown
ruby-ronn - library to build manuals from Markdown

Install ronn:

sudo apt install ronn

Convert .ronn file to man format:

ronn --roff pcm_conv.1.ronn

This generates pcm_conv.1.
View the man page:

man ./pcm_conv.1

Example .ronn file:

cat pcm_conv.1.ronn
PCM_CONV(1)                                         User Commands                                         PCM_CONV(1)

## NAME

pcm_conv - high-quality FFT/DCT-based audio resampler

## SYNOPSIS

`pcm_conv` [<input_file>] [<output_file>] [ `-c` <number> ] [ `-m` <mask> ] [ `-n` <on>`|`<off> ] [ `-I` <input_order> ] [ `-O` <output_order> ] [ `-b` <bits> ] [ `-f` <frequency> ] [ `-T` <trans> ] [ `-W` <win> ] [ `-v` ] [ `-h | --help | --help-all` ]

## DESCRIPTION

Converts WAVE files with high-quality sample rate conversion using FFT or DCT transforms.

## OPTIONS

`-c`
:    Number of output channels: 1 (mono), 2 (stereo), up to 6 (3/2+SW).

`-m`
:    Channel mask (may conflict with -c).

`-n`
:    Normalize channel matrix (default: on).

`-I` <order>, `-O` <order>
:    Input/output channel order: MS, ALSA, or OSS layout.

`-b` <bits>
:    Output bit depth: 8, 16, 24, 32, 32f, or 64f.

`-f` <value of sample rate in Hz>, e.g.: `-f` 192000  
:    Output sample rate. The range of 6000–192000 Hz is 100% reliable. Rates above 192 kHz (e.g., 1411200 Hz) appear reliable based on testing, but require further validation with `pcm_mse`.     

`-T` <dct>`|`<fft>
:    Transform type (default: dct).

`-W` <vorbis>`|`<hanning>`|`<rect>
:    Windowing function (default: vorbis).

`-v`
:    Verbose output.

`--help-all`
:    Show full help.

## FILES

/etc/fftrate.conf
:    System-wide configuration.

~/.asoundrc
:    User ALSA configuration (used by fftrate plugin).

## SEE ALSO

arateconf(1), fftrate(7)

## EXAMPLES

Convert a 32-bit WAV file to 192kHz, 32-bit fixed-point using FFT resampling:

    $ pcm_conv -f 192000 -b 32 -T fft -v *32bit.wav Faust_192kHz_32bit_downfft.wav
    Input file : 08-Faust - Funeral March Of A Marionette - 32bit.wav
     Samples rate    = 352800 Hz
     Channels        = 2
     Bits per sample = 32 (actual: 32, float)

    Output file: Faust_192kHz_32bit_downfft.wav
     Samples rate    = 192000 Hz
     Channels        = 2
     Bits per sample = 32 (actual: 32, fixed)

            FL      FR      
    FL      1.000   -----   
    FR      -----   1.000   

    Windows : "Vorbis" (37632 => 20480)
    Delay   : 107 ms
    Sync.   : ON
    Trans.  : "FFT"

    [|||||||||||||||||||||||||||||||||||||||||||||||||||]  99.0 %
    Ok.

    File duration  : 275.906667 sec
    Processing time: 13.305000 sec ( 4.82% of real time)   

## VERSION

1.6.3

## DATE

November 2025

Manual:

man ronn-format

_https://rtomayko.github.io/ronn/ronn-format.7.html

]]> Fri, 05 Dec 2025 10:13:54 +0000 https://dev1galaxy.org/viewtopic.php?pid=60391#p60391