NAME

nup - N-up output wrapper for optex -Mup

SYNOPSIS

nup [ options ] file ...
nup -e [ options ] command ...

-h,   --help             show help
      --version          show version
-d,   --debug            debug mode
-n,   --dryrun           dry-run mode
-e,   --exec             execute command mode
-V,   --parallel         parallel view mode
-F,   --fold             fold mode (disable page mode)
-H,   --header           show file headers (default: on)
-G,   --grid=#           grid layout (e.g., 2x3)
-C,   --pane=#           number of columns
-R,   --row=#            number of rows
      --height=#         page height in lines
-S,   --pane-width=#     pane width (default: 85)
--bs, --border-style=#   border style (default: heavy-box)
--ls, --line-style=#     line style (none/truncate/wrap/wordwrap)
      --pager=#          pager command (empty to disable)
      --no-pager         disable pager

VERSION

Version 0.99

DESCRIPTION

nup is a simple wrapper script for optex -Mup. It provides a convenient way to view files or run commands with N-up output formatting using the App::optex::up module.

nup automatically detects the mode based on the first argument: if it is an existing file, file view mode is used; if it is an executable command, command mode is used. Use -e option to force command mode when needed.

OPTIONS

General Options

• -h, --help

  Show help message.

• --version

  Show version.

• -d, --debug

  Enable debug mode.

• -n, --dryrun

  Dry-run mode. Show the command without executing.

• -e, --exec

  Force command execution mode. Normally the mode is auto-detected, but use this option when you want to execute a file as a command.

• -V, --parallel

  Enable parallel view mode for ansicolumn. In this mode, each file is displayed in its own column without pagination, similar to --fold. Automatically enabled when multiple files are specified. Single file or stdin input results in single column output.

• -F, --fold

  Enable fold mode (disable page mode). In fold mode, the entire content is split evenly across columns without pagination. Page mode is the default.

• -H, --header

  Show filename headers in file view mode. Enabled by default. Use --no-header to disable.

Layout Options

• -G CxR, --grid=CxR

  Set grid layout. For example, -G2x3 creates 2 columns and 3 rows.

• -C N, --pane=N

  Set the number of columns (panes).

• -R N, --row=N

  Set the number of rows.

• --height=N

  Set the page height in lines.

• -S N, --pane-width=N

  Set the pane width in characters. Default is 85.

Style Options

• --border-style=STYLE, --bs=STYLE

  Set the border style. Default is heavy-box.

• --line-style=STYLE, --ls=STYLE

  Set the line style. Available: none, truncate, wrap, wordwrap.

Pager Options

• --pager=COMMAND

  Set the pager command. Default is $PAGER or less. Use --pager= (empty) or --no-pager to disable pager.

• --no-pager

  Disable pager.

EXAMPLES

nup man nup                # view manual in multi-column
nup -C2 man perl           # 2 columns
nup -G2x2 man perl         # 2x2 grid (4-up)
nup -F man perl            # fold mode (no pagination)
nup file1.txt file2.txt    # view files side by side
nup -e ./script.sh         # force command mode for a file

INSTALLATION

Using cpanminus:

cpanm -n App::nup

DIAGNOSTICS

Both stdout and stderr of the command are merged and passed through the output filter. Error messages will appear in the paged output.

EXIT STATUS

The exit status of the executed command is not preserved because the output is passed through a filter pipeline.

SEE ALSO

App::optex::up, optex

AUTHOR

Kazumasa Utashiro

LICENSE

Copyright 2025 Kazumasa Utashiro.

This software is released under the MIT License. https://opensource.org/licenses/MIT