Issue 4490 - Install Instructions missing and there are two "setup" programs
Summary: Install Instructions missing and there are two "setup" programs
Status: CLOSED FIXED
Alias: None
Product: Infrastructure
Classification: Infrastructure
Component: Website general issues (show other issues)
Version: current
Hardware: PC Linux, all
: P3 Trivial (vote)
Target Milestone: ---
Assignee: mdekkers
QA Contact: issues@www
URL: http://www.openoffice.org/dev_docs/in...
Keywords: oooqa
Depends on: 1307 1940 3977
Blocks:
  Show dependency tree
 
Reported: 2002-05-04 16:11 UTC by Unknown
Modified: 2008-05-17 23:28 UTC (History)
5 users (show)

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


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description Unknown 2002-05-04 16:11:21 UTC
The online dev_docs/instructions.html Linux Set Up step 7 says to run ./setup
"without the -net, this time".  When I did that I again got the full
installation process.

I eventually realized that step 5 and 6 looked similar enough that after the
full-screen install finished I had looked at step 7 instead of 6.  I was in the
wrong "this directory".

Step 7 should be appended to step 6, and the start of what is now step 8 should
read "This second "setup" program will now present the user portion of setup,
which each new user should run."  This phrasing only makes sense with step 6.

A copy of the installation instructions should be in the "install" directory
along with the rest of the package.  The filename should sort after "f" so it
won't scroll off the screen when "ls" is used.

Also, there should not be two "setup" programs.  Not.  Rename one or combine
them.  ...and I think the setup GUI should have the system/user "-net" selection.

Depends on: 1307 1940 3977
Comment 1 khendricks 2002-05-04 16:50:19 UTC
Hi,

I agree the instructions should have been placed right in the 
installer directory.

The install wrapper was written to be more self-documenting for Unix 
users.  It was meant to work like this.

As root:

./install -h


then root would do something like the following:

./install --prefix=/opt


This would do the Phase 1 install directly into 
/opt/OpenOffice.org1.0 using a full Multi-User (-net) install 
typically for Unix programs (the single user install is simply a 
mistake for Unix, you can always do a net install into your own home 
if you so desire)

Then each individual user would do one of two things:

1. simply try starting up program/soffice from the installed 
location and it would in turn automatically run "setup" for the user 
the first time who would choose a WorkStation installation

or 

2. following the missing installation directions, each user would 
launch setup from the main install location themselves and do a 
workstation install.

This would complete the installation and all would be well.

However, the x86 Linux and Solaris tarballs never came with the 
README or the full (pdf version install guide) or anything.

I am the maintainer of the PPC Linux port and I added both so that 
users would understand how to run ./install and that two 
installation phases were necessary (one by root and one by the user).

You can actually get the OOo_1.0.0_README and OOo_install_guide.pdf 
(with nice screen shots taken from StarOffice 6 since OOo 1.0 was 
not yet available.

Here are the links in case they help explain this at all:

ftp://ftp.yellowdoglinux.com/pub/yellowdog/software/openoffice/OOo_1.0.0_README

ftp://ftp.yellowdoglinux.com/pub/yellowdog/software/openoffice/OOo_install_guide.pdf

IMHO: This was a mistake that should not have happened.

But there are now install directions on the main website
(but they need to make it clearer that the user is running
a different "setup" program installed by the first under a 
(multi-user net installation).


I will try to make sure this does not happen again for future 
releases.  A simple OOo_1.0.0_README is all that is really needed 
and it should come right inside the installer tarball.

I will try to get one committed to the tree and delivered 
automatically before the next release.

Thanks,

Kevin

Comment 2 Unknown 2002-05-06 07:09:10 UTC
setup.ins is missing.
Comment 3 Olaf Felka 2002-05-06 11:02:32 UTC
Perhaps we should change the websites to give more detailed information.
Comment 4 lsuarezpotts 2002-05-21 23:39:58 UTC
Hi,
Frank P sent me the up-to-date install instructions, ST has suggested
integration method. 
However, the suggestions, instructions below leave me a little
uncertain what exactly you want me to do.
please clarify.
louis
reassigning to mdekkers for resolution.
Comment 5 khendricks 2002-06-04 15:00:59 UTC
removing myself from cc on this 
Comment 6 mdekkers 2002-06-08 10:08:36 UTC
 Install instructions have been fixed, the full setup guide has been   
placed online in HTML form (with visible links to it from the   
install instructions page) at   
http://www.openoffice.org/docs/setup_guide/toc.html and the old   
linux instructions now reflect the install way of doing things,   
rather then the ./setup way of doing things    
 
The dependencies seem to be closed, or at least there is a 
workarounbd for now. Since this is really two issues (instructions 
on the web, and a new setup script), and the issue is assigned to 
"www", and there is already a discussion going on about a new setup 
script, I think I can close this issue. 
Comment 7 stx123 2004-03-22 16:11:37 UTC
For technical reasons we have to move the issue to another subcomponent tan 'www'.
Sorry for bothering you with this generated notification message. There is no
need for any action from yor side.
Thanks for your understanding, Stefan
Comment 8 ace_dent 2008-05-17 21:25:09 UTC
The Issue you raised has been marked as 'Resolved' and not updated within the
last 1 year+. I am therefore setting this issue to 'Verified' as the first step
towards Closing it. If you feel this is incorrect, please re-open the issue and
add any comments.

Many thanks,
Andrew
 
Cleaning-up and Closing old Issues
~ The Grand Bug Squash, pre v3 ~
http://marketing.openoffice.org/3.0/announcementbeta.html
Comment 9 ace_dent 2008-05-17 23:28:27 UTC
As per previous posting: Verified -> Closed.
A Closed Issue is a Happy Issue (TM).

Regards,
Andrew