Issue 2557 - document -net and other install options, implement -h or --help
Summary: document -net and other install options, implement -h or --help
Status: CLOSED NOT_AN_OOO_ISSUE
Alias: None
Product: Installation
Classification: Application
Component: ui (show other issues)
Version: 638
Hardware: PC All
: P3 Trivial (vote)
Target Milestone: ---
Assignee: christian.jansen
QA Contact: issues@installation
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2001-12-16 22:05 UTC by bulbul
Modified: 2003-09-08 16:53 UTC (History)
2 users (show)

See Also:
Issue Type: ENHANCEMENT
Latest Confirmation in: ---
Developer Difficulty: ---

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this issue.
Description bulbul 2001-12-16 22:05:59 UTC 
There is already discussion in bug 1940 about defaulting to the -net install
option. In the meantime, please *document* the feature somewhere. I can't figure
out any way to find out about the feature. It's really impossible. I knew that
some sort of network install feature existed so i tried:
   setup -network
   setup --network
   setup -n
All of these resulted in an abort. So, then i thought i'd try 
   setup --help
   setup -help
All of which aborted. Why isn't there a way to discover install options?

Then i tried looking all over OpenOffice.org. I couldn't find any installation
instructions anywhere. Not about -net or about anything else for that matter.
The only way for me to discover this was by doing a search on IssueZilla. The
README.html is an empty shell as in the README text doc. This is crazy! No one
should have to waste this much time and effort to find out about an installation
feature. Think of the frustration i would have had if i hadn't even *heard* of
the feature before. The feature is not intuitively named. The feature is useful
(and sometimes important) whether or not the computer is networked. Why not
rename the feature "multiuser".

My rant is now over. Here are the specific things i'm asking to be fixed in this
bug:

1.  Implement a -h/--help option for setup, which shows install 
    options, including -net.
2.  Document install options, including -net in the README and README.html 
    files.

I will file a separate bug to request an installation page on OpenOffice.org.
The "multiuser" label will also be filed under a separate bug.
Comment 1 Olaf Felka 2001-12-17 12:23:59 UTC 
I send these setup ideas to Falko, he is collecting them for 
further
implementations.
Comment 2 bulbul 2001-12-24 03:49:51 UTC 
I forgot to mention, an unrecognized option should not abort, but
should print out the same information as the requested -h/--help feature.
Comment 3 falko.tesch 2002-01-02 10:40:19 UTC 
This issue is re-assigned to Christian Jansen for further evaluation.
Comment 4 christian.jansen 2002-01-09 16:22:18 UTC 
Yes, the -"something" switches should be better documented. If were
going into the planning phase this will be discussed.
Comment 5 dankegel 2003-05-23 18:12:14 UTC 
See also issue 11950 and issue 14804.
Comment 6 christian.jansen 2003-06-24 09:02:47 UTC 
With OO.o 1.1 we have a "setup -help" option. So, I think this task
can be closed.