StarOffice 3.1 Mini-HOWTO
  Matthew Borowski ( mkb@poboxes.com )
  v1.0, 2 Giugno 1998

  Informazioni sull'installazione di StarOffice 3.1 Office Suite della
  StarDivision. Documentazione tradotta da Marco Meloni  (
  tonno@stud.unipg.it )

  1.  Introduzione

  Questo documento tratta dell'installazione di StarOffice 3.1. La
  versione corrente di StarOffice  la 4.0. La versione 4.0 
  considerevolmente pi facile da installare e contiene meno bug della
  versione 3.1. In effetti la mia opinione  che non serva un howto per
  installare la versione 4.0 poich la StarDivision ha scritto
  un'esauriente guida all'installazione. Questo  mini-HOWTO  stato
  utile in precedenza e viene adesso inserito negli archivi per le poche
  persone che vogliano ancora installare StarOffice 3.1. Per
  informazioni su StarOffice 4.0, date un'occhiata al mio sito web
  http://mkb.home.ml.org/linux/sohowto.html.


  La StarOffice Office Suite  una collezione di tool per l'ufficio per
  Linux, scritta in C usando il toolkit Motif.

  StarOffice include:

    StarWriter, un word processor

    StarCalc, un foglio di calcolo

    StarImage, un editor di immagini

    StarDraw, un programma di disegno simile a Corel DRAW

    StarChart, un programma per disegnare grafici

    StarMath, un editor matematico

  La StarOffice Office Suite per Linux  free per uso non commerciale.
  Un uso commerciale richiede l'acquisto di una licenza. Il costo dell'
  acquisto di una licenza commerciale separatamente dalla distribuzione
  OpenLinux di Caldera per il momento non  stato reso noto.


  1.1.  Informazioni su Motif

  StarOffice  stata scritta usando la GUI del toolkit Motif 2.0.  la
  versione linkata dinamicamente *non* funzioner con le librerie Motif
  1.2/Lesstif.

  La versione linkata staticamente (con le librerie Motif 2.0)
  funzioner anche se Motif non  installato sul vostro sistema.

  Ho fatto girare StarOffice su un Pentium 100 con 48 Mb di RAM, sotto
  Redhat 4.1 completa di Motif 2.0. La versione linkata dinamicamente
  viene caricata in circa un minuto.  comunque da notare il fatto che,
  una volta caricata, la versione linkata dinamicamente utilizza meno
  risorse di sistema della versione linkata staticamente.


  1.2.  Storia del documento


    Versione 1.0 980602 - aggiunte info su StarOffice 4.0 e sul perch
     questo documento  ormai vecchio
    Versione 0.8 971109 - aggiunti dei trucchi, installazione con
     upgrade delle libc, ecc.

    Versione 0.7 970707 - cambiata la sezione 3.1.1, cambiata la
     licenza

    Versione 0.6 970609 - aggiunto rimedio per problemi con la
     variabile LANG

    Versione 0.5 970608 - info modificate per la versione finale di
     StarOffice 3.1

    Versione 0.1 970505 - release iniziale.


  2.  Come ottenere la StarOffice Office Suite

  La versione corrente di StarOffice per Linux  3.1.   disponibile
  tramite FTP su

       ftp://ftp.gwdg.de/pub/linux/staroffice


  Il file README.StarOffice contiene informazioni sul download di
  StarOffice 3.1 versione finale. Vi serviranno tre file:


    StarOffice31-english.tar.gz (inglese) documenti di templates/demo o

    StarOffice31-german.tar.gz (tedesco) documenti di templates/demo

    StarOffice31-dynbin.tar.tgz(linkato dinamicamente) o

    StarOffice31-statbin.tar.gz (linkato staticamente) eseguibile

    StarOffice31-common.tar.gz



  Vi  anche una versione di StarOffice distribuita da Caldera.
  Guardate il loro sito web

       http://www.caldera.com

  per i dettagli.  Caldera vende anche i CDROM di StarOffice a $ 7.99
  US.


  3.  Installazione di StarOffice

  L'installazione di StarOffice consiste nel:

    Come root, decomprimere i file della distribuzione in /usr/local

    lanciare il setup come utente

    effettuare un source dei comandi in .sd.sh o .sd.csh

    leggere la sezione 3.5!!! (fatelo)


  3.1.  Problemi con le Libc e rimedi

  StarOffice utilizza le libc 5.4.4.


  StarOffice 3.1 *funzioner* con le Libc 5.3.x. Sfortunatamente, il
  programma di setup richiede la versione 5.4.4 o superiore delle libc.
  Se avete le libc 5.3.x, potete rimediare a questo con una copia delle
  libc 5.4.4+ e impostando la variabile LD_LIBRARY_PATH prima di
  eseguire lo script di setup. Comunque non ho testato la cosa
  personalmente, per cui fate un po' voi.


  Se cercate di eseguire lo script di setup con delle libc pi vecchie
  delle 5.4.4, avrete il seguente messaggio di errore:


       line 1: Syntax error at token 'I' expected declarator; i.e. File ...



  Per aggiornare le libc, fate FTP su sunsite.unc.edu e cercate nella
  directory /pub/Linux/GCC il file libc-5.4.33.bin.tar.gz (o qualunque
  sia l'ultima versione).  Estraete il contenuto di questo file su una
  directory temporanea.  Vi sar adesso una directory lib/ . Da root
  copiate il file libc.so.5.4.33 da questa directory alla vostra
  directory /lib. Adesso fate un link simbolico da libc.so.5 a
  libc.5.4.33 con il comando:



       ln -sf /lib/libc.so.5.4.33 /lib/libc.so.5

  ed eseguite il comando ldconfig.


  Il Dr. Romano Giannetti (romano@iet.unipi.it ) dice che:



       ... vorrei solo aggiungere che si pu installare (come da te
       suggerito) StarWriter in un sistema con Redhat 4.2 che
       utilizza le libc5.3 senza effettuare l'upgrade.

       I passi da compiere sono:


       1. ottenere le libc.so.5.4.x. Se esse sono in un package rpm
       (come quelli che si trovano nella directory contrib), 
       possibile estrarre la libreria andando su una directory
       temporanea ed eseguendo il comando:

       rpm2cpio libc.so.5.4.x-y.rpm | cpio --extract --make-
       directories

       La libreria si trover nella subdirectory ./lib


       2. muovere il file libc.so.5.4.x nella propria home
       directory. Dopodich (assumendo che si usi una shell tipo
       sh):

       ln -s libc.so.5.4.x libc.so.5

       export LD_LIBRARY_PATH=$HOME:/lib:/usr/lib


       3. Adesso si pu far partire il setup.



  3.2.  Installazione dei file tar

  Dopo aver scaricato StarOffice, da root mettere i file archivio in
  /usr/local/. Andare in  /usr/local/ ed estrarre i file
  dell'installazione. Un esempio di comando che estrae un file tar e
  compresso con gz pu essere:



       tar -xzvf nomefile.tar


  I sistemi pi vecchi potrebbero richiedere l'esecuzione del comando
  gzip -d per decomprimere il file,  poi sufficiente usare il comando
  tar -xvf per estrarre i file dall'archivio di tar.

  I file saranno estratti nelle loro posizioni sulla nuova directory
  usr/local/StarOffice-3.1.


  3.3.  Setup e configurazione

  Dopo aver estratto i file di StarOffice come root, si effettui il
  login con il proprio username. Andare sulla directory
  /usr/local/StarOffice-3.1 ed eseguire il programma di setup. Questo
  programma installer i file non condivisi ed effettuer i link
  simbolici che servono per ogni utente. La modalit di installazione
  raccomandata  quella standard. Ci *potrebbero* essere problemi se non
  si accetta il percorso predefinito di installazione.

  StarOffice usa per il suo funzionamento le variabili d'ambiente.  I
  file .sd.sh  (formattato per la Bourne Shell) e .sd.csh (formattato
  per la C Shell) forniscono i valori appropriati a StarOffice per le
  suddette variabili. Questi file sono collocati nella home directory
  dell'utente.


  Se si ritiene di usare bash, modificare il proprio .bashrc aggiungendo
  la linea:


       source  /.sd.sh


  Dopo questo, far ripartire la bash per rendere effettivo il
  cambiamento.

  Se si usa una shell differente dalla bash consultarne il manuale per
  sapere come effettuare l'operazione analoga.


  3.4.  Bug del Setup di COL (Caldera OpenLinux)

  Phil Reardon (pcr@busprod.com ) ha scritto:

       " Ho trovato un bug nello script di setup per StarOffice che
       era nella mia versione standard di Caldera OpenLinux. Lo
       script produce // in un percorso dove dovrebbe esserci solo
       un /.  Per rimediare basta rimuovere il primo slash da
       questa linea:

       exec ${pfad:='.'}/linux-x86/bin/$name;;


  Non ci dovrebbero essere / prima di linux-x86."

  3.5.  Come risolvere il problema con la variabile LANG

  I file .sd.sh e .sd.csh impostano la variabile LANG.  Questo causa dei
  problemi con perl e man. Man dar il seguente messaggio d'errore:

       " Failed to open the message catalog man on the path
       NLSPATH="

  Perl dar quest'altro errore:

       " warning: setlocale(LC_CTYPE, "")..."


  Il file .sd.sh contiene una linea dove la variabile LANG viene
  impostata a "us" ( LANG=us ) ed un'altra esporta una serie di
  variabili, LANG inclusa. Per rimediare basta rimuovere la linea
  LANG="us" e rimuovere LANG dalla lista delle variabili.

  Nel file .sd.csh (formattato per la c shell), servir rimuovere la
  linea dove appare "setenv LANG us".

  Un grazie ad Adam L. Klein (alklein@adelphia.net) per avermi informato
  di questo rimedio.


  4.  Come lanciare StarOffice

  I binari di StarOffice sono nella directory:
  /usr/local/StarOffice-3.1/linux-x86/bin/

  Le applicazioni sono: sdraw3, swriter3, scalc3, smath3, schart3,
  simage3

  Il programma svdaemon deve essere eseguito per poter usufruire
  dell'help in linea.  Il programma svportmap deve essere eseguito per
  abilitare la funzionalit di comunicazione tra le applicazioni
  StarWriter, StarCalc e StarDraw.


  5.  Alcuni accorgimenti

  A cura di Patrick D'Cruze (pdcruze@netpal.com.au)


  1.  Invece di effettuare un "source" di .sd.sh (o .sd.csh) nel mio
  .bash_profile, ho copiato .sd.sh,  lo ho rinominato come swriter e lo
  ho messo in /usr/local/bin.  Lo ho poi modificato aggiungendo:

       #! /bin/bash



  all'inizio dello script e:

       exec swriter3 $*


  alla fine dello script.  Adesso tutto quello che devo fare  lanciare
  swriter e lui automaticamente imposta le variabili d'ambiente
  appropriate e fa partire StarWriter. Questo evita che le variabili
  d'ambiente impostate da StarOffice inquinino altre
  applicazioni/ambienti.

  2.  Ho notato che per molta gente StarOffice ci mette un bel po' per
  partire (pi di 60 secondi).  risultato, dalle discussioni su usenet,
  che gran parte di questo tempo va perso nella rilocazione dei simboli
  (symbol relocation) che il linker dinamico deve effettuare. Per ogni
  nuovo simbolo il linker deve trovare la libreria adatta. StarOffice 
  linkato dinamicamente con poche librerie ma il linker spende gran
  parte del tempo nella ricerca in mezzo a molte altre librerie.

  A questa cosa si pu porre rimedio. Io faccio girare StarOffice in un
  ambiente chiuso (chroot'd jail).  sufficiente porre in questo
  ambiente i binari e le librerie che StarOffice usa (tutte quelle sotto
  /usr/X11R6/lib, libc/libm e libg++/libstdc++). In questa maniera
  StarWriter impiega 15 secondi per partire sul mio P133/32Mb. Questo 
  dovuto al fatto che le sole librerie presenti sono quelle che servono
  a StarOffice e quindi il linker dinamico impiega proporzionalmente un
  tempo inferiore nella ricerca fra le librerie del sistema (non cerca,
  ad esempio, fra tutte le librerie inutili in /usr/lib).



  6.  Ulteriori informazioni

  Altre informazioni su StarOffice per Linux sono disponibili
  direttamente dalla StarDivision. La StarDivision ha un sito web
  http://www.stardivision.com

  La StarDivision mantiene un news server con gruppi di discussione sul
  supporto e sull'uso di StarOffice per Linux. Questi gruppi di
  discussione sono il posto migliore dove cercare per le ultime
  informazioni riguardanti StarOffice ed anche un posto dove chiedere
  aiuto. Con un programma che consente di leggere i gruppi di
  discussione, collegarsi a news://starnews.stardivision.com o seguire
  il link della homepage della StarDivision riguardante l'assistenza.


  7.  Contributi

  Un grazie a Werner Klaus (wklaus@metronet.de ) per aver tradotto
  questo documento in sgml.

  Se avete informazioni addizionali per questo mini-HOWTO, contattatemi
  via email. Il mio indirizzo  all'inizio del documento. Potreste anche
  aver voglia di visitare la mia homepage all'indirizzo
  http://mkb.home.ml.org/linux/ o http://www.gslink.com/~mkb/linux/.

  Nota del traduttore : per quanto riguarda la traduzione italiana di
  questo documento, segnalate eventuali errori, inesattezze e
  quant'altro all'indirizzo del traduttore all'inizio di questo
  documento. Se avete aggiunte da mandare all'autore ma non sapete
  l'inglese potete inviarle al traduttore. La sezione "disclaimer e
  copyright"  lasciata anche in lingua originale.


  8.  Disclaimer e Copyright

  This document is (C) 1997 by Matthew Borowski.

  Redistribution of this document in electronic form is permitted under
  the condition that the document remains unchanged. If you wish to
  include this document in a CD-ROM or book, please obtain permission
  from me beforehand (I prefer requests to be sent via e-mail).


  The author claims no responsibility in anything that may occur
  directly or indirectly as a result of using this document. The author
  is not an employee of StarDivision, GmbH or Caldera, Inc.

  Questo documento  sotto copyright (C) 1997 da parte di Matthew
  Borowski.
  La ridistribuzione di questo documento in forma elettronica  permessa
  a patto che questo documento rimanga inalterato. Se si vuole includere
  questo documento in un CD-ROM o in un libro, si prega di ottenerne
  prima il mio permesso (preferisco che le richieste vengano spedite via
  email).

  L'autore non si assume responsabilit per qualsiasi conseguenza
  diretta o indiretta causata dall'uso di questo documento. L'autore non
   un impiegato della StarDivision, GmbH o della Caldera, Inc.


  Commenti e domande possono essere rivolti all'autore mkb@poboxes.com.