Issue 13097 - Create documentation for W32-tcsh builds
Summary: Create documentation for W32-tcsh builds
Status: CLOSED FIXED
Alias: None
Product: Build Tools
Classification: Code
Component: documentation (show other issues)
Version: 644
Hardware: PC Windows 2000
: P3 Trivial (vote)
Target Milestone: ---
Assignee: Unknown
QA Contact: issues@tools
URL:
Keywords:
Depends on:
Blocks: 12046
  Show dependency tree
 
Reported: 2003-04-06 19:41 UTC by quetschke
Modified: 2003-04-13 10:18 UTC (History)
6 users (show)

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


Attachments
Patch for www\www\styles\build_template.html (23.09 KB, patch)
2003-04-06 19:42 UTC, quetschke
no flags Details | Diff
Patch for www\www\styles\mkbuilddoc (2.34 KB, patch)
2003-04-06 19:42 UTC, quetschke
no flags Details | Diff
Generated W32-tcsh build instructions (26.26 KB, text/html)
2003-04-06 19:43 UTC, quetschke
no flags Details
Arghh, typo in build_template.diff! Use this! (23.09 KB, patch)
2003-04-06 19:47 UTC, quetschke
no flags Details | Diff
Correct build_win_tcsh.html (26.26 KB, text/html)
2003-04-06 19:49 UTC, quetschke
no flags Details
Patch for build_template.diff (10.47 KB, patch)
2003-04-07 19:09 UTC, quetschke
no flags Details | Diff
build_win_tcsh.html (26.66 KB, text/html)
2003-04-07 19:10 UTC, quetschke
no flags Details
Patch for build_template.html (10.67 KB, patch)
2003-04-08 13:05 UTC, quetschke
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this issue.
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