Issue 13097

Summary: Create documentation for W32-tcsh builds
Product: Build Tools Reporter: quetschke
Component: documentationAssignee: Unknown <non-migrated>
Status: CLOSED FIXED QA Contact: issues@tools <issues>
Severity: Trivial    
Priority: P3 CC: foskey, issues, lsuarezpotts, maho.nakata, nesshof, stx123
Version: 644   
Target Milestone: ---   
Hardware: PC   
OS: Windows 2000   
Issue Type: DEFECT Latest Confirmation in: ---
Developer Difficulty: ---
Issue Depends on:    
Issue Blocks: 12046    
Attachments:
Description Flags
Patch for www\www\styles\build_template.html
none
Patch for www\www\styles\mkbuilddoc
none
Generated W32-tcsh build instructions
none
Arghh, typo in build_template.diff! Use this!
none
Correct build_win_tcsh.html
none
Patch for build_template.diff
none
build_win_tcsh.html
none
Patch for build_template.html none

Description quetschke 2003-04-06 19:41:17 UTC 
The following patches change www/www/styles/build_template.html and mkbuilddoc
to generate an additional build_win_tcsh.html.

build_win_tcsh.html contains the documentation how to build OOo on windows
without 4NT using the Cygwin tools instead.

When the build_win_tcsh.html is available I'd like to change the Build Process
part of tools.openoffice.org website to look like this:

Descriptions of the Build Process

~    * Linux
~    * Solaris
~      Glen Kreikenbeck's paper on building OOo on Solaris)
~    * Mac OSX
~    * Windows (Using 4NT + MSVC)
~    * Windows (Using Cygwin tcsh + MSVC. Beware this is experimental!)

Please check the patch for gramatical/spelling errors.
Comment 1 quetschke 2003-04-06 19:42:11 UTC 
Created attachment 5488 [details]
Patch for www\www\styles\build_template.html
Comment 2 quetschke 2003-04-06 19:42:49 UTC 
Created attachment 5489 [details]
Patch for www\www\styles\mkbuilddoc
Comment 3 quetschke 2003-04-06 19:43:53 UTC 
Created attachment 5490 [details]
Generated W32-tcsh build instructions
Comment 4 quetschke 2003-04-06 19:47:31 UTC 
Created attachment 5491 [details]
Arghh, typo in build_template.diff! Use this!
Comment 5 quetschke 2003-04-06 19:49:45 UTC 
Created attachment 5492 [details]
Correct build_win_tcsh.html
Comment 6 Unknown 2003-04-07 16:09:53 UTC 
I checked in the new build_template, mkbuilddoc script and 
the resulting build docs. I added a link to build_win_tcsh.html 
at the top of build_windows.html instead of creating a second 
link to windows build docs on the documentation page. In the future, 
build_win_tcsh.html should replace build_windows.html.
Comment 7 quetschke 2003-04-07 19:08:04 UTC 
I found some general problems in the markup. The following patches
fix the format of build_template.html and the generated build_*.html
files.

The following patch fixes this.
Comment 8 quetschke 2003-04-07 19:09:23 UTC 
Created attachment 5515 [details]
Patch for build_template.diff
Comment 9 quetschke 2003-04-07 19:10:08 UTC 
Created attachment 5516 [details]
build_win_tcsh.html
Comment 10 quetschke 2003-04-07 19:12:24 UTC 
OK to commit?
Comment 11 Unknown 2003-04-08 11:57:53 UTC 
approved
Comment 12 quetschke 2003-04-08 13:03:19 UTC 
Hmmm, I cannot commit:

User vq doesnt have <Commit> access to project www

Can you please commit the *following* ;-) changes to build_template.html?
(I broke the very long configure line for win_tcsh in three pieces,
otherwise the frame is as wide as this long line. Looks ugly.)
And the four generated html files.

Or shall I ask for content developer status in www? Whom?
Comment 13 quetschke 2003-04-08 13:05:08 UTC 
Created attachment 5528 [details]
Patch for build_template.html
Comment 14 stx123 2003-04-09 15:01:46 UTC 
Louis, Martin,
I would like to recommend the move of build_template and mkbuilddoc 
from www/www/styles to tools/www/<somewhere>.
This would ease integration of Ken's, Volker's and other's 
contributions.
Greetings, Stefan
Comment 15 quetschke 2003-04-09 15:47:26 UTC 
Added Ken to CCs.

As mentioned on IRC I tried to commit build_template.html to

  tools/www/dev_docs/build_template.html

Doesn't work either: cvs server: cannot add file on non-branch tag HEAD
Comment 16 quetschke 2003-04-09 17:10:39 UTC 
Committed tools/www/dev_docs/build_template.html
Comment 17 Unknown 2003-04-10 14:17:24 UTC 
??? but build_template.html used to live in www/styles/
Comment 18 stx123 2003-04-10 14:57:27 UTC 
Hi Armin, see my earlier comments: it used to :-)
Now the template, the script and the generated documents found a new
home: tools/www/dev_docs
This makes it easier to allow "content developers" to contribute.
Greetings
Stefan
Comment 19 quetschke 2003-04-13 10:18:31 UTC 
Documents moved to tools/www/dev_docs , including the W32-tcsh
documentation.
Comment 20 quetschke 2003-04-13 10:18:52 UTC 
c