Solaris 8 Installer CD localization notes/guide		        11/19/99

- Localizable Components

   SUNW0icd package   
   ----------------

   The SUNW0icd package contains English source for L10N translations
   that will be part of the Solaris Installation CD mini-root.  The
   CD mini-root is used during the first boot from the Installation CD.
   This mini-root supports just the simple text prompts that occur
   during the Installation CD's first boot.  

   - Release Notes
	12/08/1999 4296802 - warn user that all information on Solaris
			     fdisk part will be lost.
			     findswap.msg was updated to fix this. It was 
			     very confusing. If the new message is not
			     translated, the it will default to the old message

   SUNW0icdd package   
   -----------------

   The SUNW0icdd package contains English source for L10N translations
   that will be part of the Solaris Installer CD Disk mini-root.  The
   Disk mini-root runs later in the Installation CD cycle.  It supports
   Java based Web Start Wizards which install the OS.

   Note: In addition to the normal delivery of the various *.class files 
	 in the SUNW<loc>icdd packages -- Please deliver a translated 
	 InstallResources_xx.java and WizardResources_xx.java source file
         back to the Web Start Wizard Team.  

	 To deliver, please send email to "merlin-iteam@installzone.eng". 
	 Title the email "Web Start 3.0 L10N files".  Attach the translated 
	 InstallResources_xx.java and WizardResources_xx.java files.

   -Release Notes
	12/02/1999 4296465 - About box copyright should be updated to from 
		   1999 to 2000.  MSG50 InstallResources.java 
	11/30/1999 Added new message (MSG620) to SolarisInstallResources.java 
                   required to fix bug id 
		   4251936 - Solaris wizard initialization should check 
                             for Solaris image on /cdrom
	11/19/1999 Added new messages required for fix to bugid 
		   4275055 - puting the swap slice in the middle of the 
			     disk results in install failure
		   Messages #'s added to SolarisInstallResources.java
			MSG1040, MSG1041, MSG1042, MSG1043.
		   These are cli mode changes only.
		  
        11/9/1999 Added new help file:
                  webstart/media_kits/products/pd_files/help/C/DocServerJCKT2.8
                  for bug 4284330.
        11/8/1999 Modified help files to match new names of Solaris Doc CDs: 
                     webstart/media_kits/products/cds/help/C/doccd 
                                                             doccdeu 
                                                             doccdjckt


   SUNW0icdl package 
   -----------------

   The SUNW0icdl package contains English source for L10N translations
   for the Solaris Wizard Launcher.  This package will be part the Solaris 
   Installer CD Disk mini-root and also part of the Solaris OS SoftwareCD 
   mini-root.  
   

   Obtain the SUNW0icd, SUNW0icdd, and SUNW0icdl packages from the Solaris 8 
   RE area at ...

   /net/paradise.eng/export/integrate_dock/s28_sunw0/all/SUNW0icd 
   /net/paradise.eng/export/integrate_dock/s28_sunw0/all/SUNW0icdd 
   /net/paradise.eng/export/integrate_dock/s28_sunw0/all/SUNW0icdl 

   The SUNW0icd package contains three script run msg files.  These are the 
   same type of files as used for CDE localization.  The English version of 
   these files will be installed at:  

   /webstart/lib/locale/C/cpiodisk.msg
   /webstart/lib/locale/C/findswap.msg
   /webstart/lib/locale/C/getLocale.msg

   The SUNW0icdd package contains five Java based text list resource files. 
   The SUNW0icdd will install the English version of the files at:

   /webstart/wizards/apps/com/sun/wizards/WizardResources.java
   /webstart/wizards/apps/com/sun/install/InstallResources.java
   /webstart/wizards/apps/com/sun/solarisinstall/SolarisInstallResources.java
   /webstart/wizards/apps/com/sun/sysid/SysidResources.java

   The SUNW0icdl packages contains one Java based resource file at:

   /webstart/wizards/apps/com/sun/launcher/LauncherResources.java

- Starting translations for the 9 standard Solaris locales

   NOTE: The above files were originally translated by Computer Systems
   for the May 1999 FCS CS release of this installer CD.  Those starting
   translatations can be found at ...

   /net/installzone.eng/export/install/cd0_cs2/src

   subdirectories ...

       .../wizards/apps/wizards/com/sun/sysid/*.java
       .../wizards/apps/wizards/com/sun/launcher/*.java
       .../wizards/apps/install/com/sun/solarisinstall/*.java
       .../locale/cd0/sparc/<locale name>/*.msg

   and at ...

   /net/installzone.eng/export/install/Merlin/SDK3.0_cs2/

   subdirectories ...

	.../install/src/com/sun/install/*.java
	.../wizards/src/com/sun/wizards/*.java


- Application used to create/edit this File type. 

      standard text editor.

-Build/compilation procedure for this file type (if applicable).

   Install SUNW0icd and SUNW0icdd with a pkgadd to a machine for the L10N 
   work area.

   From this L10N work area, to compile, the Java command is ...

      cd /webstart/wizards/apps

      javac com/sun/*/*.java

   Follows standard JDK 1.1 localization conventions.  For locale translation,
   use copy of the english resource files, but add the locale tag at the 
   end of the copied file's name.  For example, the five resource files
   copied and translated for French "fr" locale would be named ...

      com/sun/solarisinstall/SolarisInstallResources_fr.java
      com/sun/launcher/LauncherResources_fr.java
      com/sun/sysid/SysidResources_fr.java
      com/sun/wizards/WizardResources_fr.java
      com/sun/install/InstallResources_fr.java

   Within the translated Resource files, change the class's name is same 
   way by adding the locale tag.  Again for a French example the class 
   name line would look like ...

      public class SolarisInstallResources_fr extends ListResourceBundle
      public class LauncherResources_fr extends ListResourceBundle
      public class SysidResources_fr extends ListResourceBundle

   For the installer.msg file, copy and translate it, then produce a
   installer.cat file by doing ...

      gencat cpiodisk.cat cpiodisk.msg 
      gencat findswap.cat findswap.msg 
      gencat getLocale.cat getLocale.msg 

   Each of the SUNW0 packages also contans a greatly simplified CDE workspace 
   menu.  The Menu source will be found at ...

     usr/dt/config/C/sys.dtwmrc 

   The translated version should be installed at ...

     usr/dt/config/<locale name>/sys.dtwmrc 

- Where they resides in CD Mini-Root and Disk Mini-Root filesystem --

   When translations are complete, deliver the localized versions of
   the SUNW0icd and SUNW0icdd packages back to the Solaris 8 RE doc
   as two separate packages for each of your L10N langusgae tranlsations.

   For the SUNW0icd localized Solaris 8 Installer "CD" Mini-Root, the 
   localized *.cat files need to be located at: 

     /webstart/lib/locale/<locale>/cpiodisk.cat
     /webstart/lib/locale/<locale>/findswap.cat
     /webstart/lib/locale/<locale>/getLocale.cat

   Note, the installer.cat file will need to have been created on a
   Sparc system AND also on an Intel system with the gencat command.

   For the SUNW0icdd localized Solaris 8 Installer "Disk" Mini-Root, the 
   localized *.class Java files need to be located at: 

  /webstart/wizards/apps/com/sun/solarisinstall/SolarisInstallResources_xx.class
  /webstart/wizards/apps/com/sun/launcher/LauncherResources_xx.class
  /webstart/wizards/apps/com/sun/sysid/SysidResources_xx.class
  /webstart/wizards/apps/com/sun/wizards/WizardResources_fr.class
  /webstart/wizards/apps/com/sun/install/InstallResources_fr.class

   Where "xx" is the locale code, such as "fr" for French.

   To test, recieve the test Installer CD back from CS RE and place in
   the CDrom drive.

   Type ...

      boot cdrom

   And follow the on screen instructions to step thru an install.

   The original messages seen are test messages on the console and are
   controled by the ".cat" files. 

   Later when the Desktop is started, the messages in the window based
   wizard panels are controled by the Java ".class" resource files.

-Access Mode details (if applicable)

   Readable files for all users.  Write, only for owner (root).

-Contact name and email address of "expert" for this file type. 

    Solaris Installer CD I18N contact: John Perry, perry@eng.sun.com, x87859

    Solaris 8 RE contact: Timothy Schmidt, tps@eng.sun.com, x89208 

    L10N Coordination: William Owen, wowen@eng.sun.com, x85475
		       Pamela Millar, pmillar@eng.sun.com, x88371

- Other L10N work ... Kiosk  

  There is also a Netscape based information browsable area called
  the "Kiosk".  Kiosk contents are still being worked on with Marketing.
  Some place holder contents are in current builds (pre-Beta).  This 
  content is expected to change and is not expected to be translated at
  this time.  The Kiosk contents are provided to L10N in a separate 
  SUNW0icdk package.  See that package for its spearate L10N instructions.

5. Test Specifications

 -Software specifications

     Any Solaris 8 system

 -Contact name and address for Install group Test

     Domestic Testing for CS Installer CD:

     Mary Ding, ding@eng, x88317

6.Bug reporting requirements:

 -Bugtraq category and subcategory to which localization bugs should be assigned.
     category:       solaris_install_cd 

     subcategories:  i18n
		     l10n_asia
   		     l10n_euro 
                     l10n_japan

7. Tools

8. Other Requirements
