Hey everyone,

There did not seem to be a man page for openoffice, so I made one.

I used the commands from 
https://wiki.services.openoffice.org/wiki/Framework/Article/Command_Line_Arguments
I also had a quick look at a style guide, 
https://manpages.debian.org/bookworm/manpages/man-pages.7.en.html

The file, soffice.1, is as follows;
___

.TH SOFFICE 1 2025-11-12 soffice

.SH NAME
soffice - Apache OpenOffice is an open-source office productivity software
suite developed by the Apache Software Foundation.

.SH SYNOPSIS
soffice [options] [documents]

.SH DESCRIPTION
The suite includes applications for word processing (Writer), spreadsheets
(Calc), presentations (Impress), vector graphics (Draw), database
management (Base), and formula editing (Math). It supports the OpenDocument
format and is compatible with other major formats.

.SH OPTIONS
-accept=<accept-string>       Specify an UNO connect-string to create an UNO
acceptor through which other programs can connect to access the API.

-base       Creates a new database document.

-calc       Creates a new spredsheet document.

-display <display>      Specifies X-display to use in Unix/X11 versions.

-draw       Creates a new drawing document.

-global     Creates a new global text document.

-headless   Suppresses any modal dialog so Apache OpenOffice can run
without user interaction. This is NOT designed to run AOO as a
"background" process. The Office starts and is able to open
document views. It's the task of a developer to use the API
correctly to assure that no UI is shown (includes -invisible).

-help/-h/-?       Shows a small message box with information about the
arguments (Windows) or outputs it to stdout.

-helpbase   Opens the OOo help application and shows the Base specific help
chapter.

-helpbasic  Opens the OOo help application and shows the Basic specific
help chapter.

-helpcalc   Opens the OOo help application and shows the Calc specific help
chapter.

-helpdraw   Opens the OOo help application and shows the Draw specific help
chapter.

-helpimpress      Opens the OOo help application and shows the Impress
specific help chapter.

-helpmath   Opens the OOo help application and shows the Math specific help
chapter.

-helpwriter       Opens the OOo help application and shows the Writer
specific help chapter.

-impress    Creates a new presentation document.

-invisible  Initially no start up screen, no default document and UI is
shown. It's possible to show documents via API. This option is
not designed to use AOO as a "background" process. The API
developer has to make sure that the views are opened
non-visible.

-language=<iso language code>       Preset a user interface language. The
Office uses a fallback mechanism if the
provided language is not available.

-math       Creates a new formula document.

-minimized  keeps start up bitmap minimized.

-n    Always open documents as new files (use as templates).

-nodefault  Don't start with an empty document.

-nofirststartwizard     Don't show the first start wizard on the first
start. A needed default user configuration is
copied without user interaction.

-nolockcheck      Don't check for remote instances using a .lock file in the
user folder.

-nologo     Don't show the splash screen.

-norestore  Suppress restart/restore after a fatal error.

-o    Opens a document regardless whether they are templates or not.

-p <documents...>       Print the specified documents on the default printer.

-plugin     Make AOO aware that it's embedded in a browser. DEPRECATED

-psn  Is used for interproces communication with the Finder on MacOS X
platforms.

-pt <printer> <documents...>  Print the specified documents on the
specified printer.

-portal     DEPRECATED and not supported anymore. Will be removed in future
versions.

-quickstart       Start the quickstart service (only available on Windows and
OS/2 platform).

-quickstart=no    Disable quickstart service.

-server     Disables recovery and session management. Command line
arguments which would open a document are ignored. No default
document will be opened.

-show <presentation>    Open the specified presentation and start it
immediately.

-terminate_after_init   The Office terminates after the initialization
phase automatically.

-unaccept=<accept-string>     Close an acceptor that was created with
-accept=<accept-string>. Use -unaccept=all
to close all open acceptors.

-userid=<path to user configuration>      Start the Office using the provided
user installation folder. DEPRECATED

-view <documents...>    Open the specified documents in
viewer-(readonly-)mode.

-web  Creates a new HTML document.

-writer     Creates a new text document.

Remaining arguments will be treated as filenames or URLs of documents to
open.

.SH COPYRIGHT
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
___

This code was also posted to https://pastebin.com/GqzNDjnT, incase the 
formatting goes bad when emailed.

I included the boilerplate from https://www.apache.org/licenses/LICENSE-2.0 for 
the copyright section.

To install,
# First, ensure your local man page directory exists for your section of
# interest (section 1 in this case, so the `man1` dir)
sudo mkdir -p /usr/local/share/man/man1

# Option 1: **copy** over the man page to section 1
sudo cp examplecommand.1 /usr/local/share/man/man1/

# Run the mandb command. This will update man's internal database
sudo mandb
(Sourced from 
https://askubuntu.com/questions/244809/how-do-i-manually-install-a-man-page-file)

I wrote the code using VSCodium (https://vscodium.com/), which is a 
community-driven, freely-licensed binary distribution of Microsoft’s editor VS 
Code. It does not contains telemetry/tracking that is present in vscode and is 
released under the MIT license.

Hope you are all doing well.

Enjoy,
Dean

Reply via email to