incubator-ooo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ksch...@apache.org
Subject svn commit: r1206881 - in /incubator/ooo/ooo-site/trunk/content/tools/tools: ./ build.html optimizer.html
Date Sun, 27 Nov 2011 22:32:20 GMT
Author: kschenk
Date: Sun Nov 27 22:32:20 2011
New Revision: 1206881

URL: http://svn.apache.org/viewvc?rev=1206881&view=rev
Log:
 kls -- added tools/tools



Added:
    incubator/ooo/ooo-site/trunk/content/tools/tools/
    incubator/ooo/ooo-site/trunk/content/tools/tools/build.html   (with props)
    incubator/ooo/ooo-site/trunk/content/tools/tools/optimizer.html   (with props)

Added: incubator/ooo/ooo-site/trunk/content/tools/tools/build.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/tools/tools/build.html?rev=1206881&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/tools/tools/build.html (added)
+++ incubator/ooo/ooo-site/trunk/content/tools/tools/build.html Sun Nov 27 22:32:20 2011
@@ -0,0 +1,103 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1251">
+	<TITLE>Description of build.pl</TITLE>
+	<META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1  (Win32)">
+	<META NAME="CREATED" CONTENT="20020702;11311540">
+	<META NAME="CHANGED" CONTENT="20030620;16194129">
+</HEAD>
+<BODY LANG="en-US" DIR="LTR">
+<H1>Build tool</H1>
+<P>The build tool is a tool written in Perl. It reads the file
+&lt;build.lst&gt; in the prj directory of the cvs module, builds a
+dependencies chain and according to the chain goes through the
+directories of the module calling dmake in each of them. It can also
+generate a shell script (-file option), which can be started
+afterwards. All directories to build and their dependencies are
+listed in the file &lt;build.lst&gt;. The build.lst has the following
+format:</P>
+<OL>
+	<LI><P>two character prefix of the project (obsolete)</P>
+	<LI><P>directory name (described in Windows\MSDOS pathname
+	convention; using a backslash '\' between each subdirectory)</P>
+	<LI><P>The action to be done. Usually the name of the make-tool, for
+	historical reason still called nmake. There is also a get-action
+	which indicates, that this directory contains source files but no
+	makefiles. If the third entry is a &quot;:&quot; the next entry is a
+	list of dependent modules. This list has to be terminated with an
+	'NULL' string.</P>
+	<LI><P>Special Entry. I have no idea what this is for. In all cases
+	'-'.</P>
+	<LI><P>platform: Used if this directory is only relevant for
+	platform 'x'. 'x' is a placeholder for &quot;all, w, p, m u&quot;.
+	all stands for all platforms, w for windows, p for OS/2
+	(Presentation Manager), u for Unix platforms.</P>
+	<LI><P>Name for directory: Unique name for this directory.</P>
+	<LI><P>List of dependency for this directory. List has to be
+	terminated with 'NULL'. The list contains list or directory names.
+	No circular dependencies are allowed.</P>
+</OL>
+<P>Example for an build.lst:</P>
+<PRE>
+<FONT FACE="Terminal, monospace">
+#=========================================================================
+r rsc : tools NULL
+r rsc\source\misc nmake - all rsc_misc NULL
+r rsc\source\tools nmake - all rsc_tool NULL
+r rsc\source\res nmake - all rsc_res NULL
+r rsc\source\parser nmake - all rsc_pars NULL
+r rsc\source\rsc nmake - all rsc_rsc NULL
+r rsc\source\prj nmake - all rsc_sprj rsc_misc rsc_tool rsc_res rsc_pars rsc_rsc NULL
+r rsc\inc get - all rsc_inc NULL
+r rsc\util nmake - all rsc_util rsc_sprj NULL
+</FONT>
+</PRE>
+<BR>
+<P>The build accepts following switches:</P>
+<UL>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--file|-F
+	&lt;filename&gt;</B>: write build shell script into &lt;filename&gt;</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--all|-a[:prjname]</B>
+	builds all projects from very beginning [starting from prjname, i.e.
+	set the -all sequence forward when build was broken in prjname] till
+	current one.</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--since|-c
+	&lt;prjname&gt;</B>: the same as '--all:prjname', but omitting
+	&lt;prjname&gt; build</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--from|-f
+	&lt;prjname:broken_build_prj [prjname1 [prjname2 [...prjnameN]]]&gt;</B>:
+	build all projects dependent from &lt;prjname [prjname...]&gt; till
+	current one starting from broken_build_prj</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--with_branches|-b</B>:
+	 build all projects in neighbour branches and the current branch
+	till current project.</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--show|-s</B>:
+	do not build, only show what is going to be done</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--deliver|-d</B>:
+	only deliver, do not build</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>-dlv_switch</B>:
+	use deliver with switches passed</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>--help|-h</B>:
+	print help</FONT></FONT></P>
+	<LI><P><FONT FACE="Thorndale, serif"><FONT SIZE=2 STYLE="font-size:
10pt"><B>-P
+	&lt;number&gt;</B>: start &lt;number&gt; processes if possible
+	(Unices only), works on modules level as well</FONT></FONT></P>
+	<LI><P><FONT SIZE=2 STYLE="font-size: 10pt"><FONT FACE="Thorndale,
serif"><B>--prepare|-p</B><SPAN STYLE="font-weight: medium">:
+	prepare the workspace for incompatible build (recommended to use
+	with &ldquo;<B>--from prjname</B>&rdquo; switch when you have
+	incompatible changes in <B>prjname </B>project (see description to
+	&ldquo;-from&rdquo; switch))</SPAN></FONT></FONT></P>
+	<LI><P STYLE="font-weight: medium"><FONT FACE="Thorndale, serif"><FONT
SIZE=2 STYLE="font-size: 10pt"><B>--ignore|-i</B>:
+	ignore all errors</FONT></FONT></P>
+	<LI><P STYLE="font-weight: medium"><FONT FACE="Thorndale, serif"><FONT
SIZE=2 STYLE="font-size: 10pt"><B>--version|-v</B>:
+	print tool version</FONT></FONT></P>
+	<LI><P STYLE="font-weight: medium"><FONT FACE="Thorndale, serif"><FONT
SIZE=2 STYLE="font-size: 10pt"><B>--
+	dmake_switch1 [dmake_switch2[ ...dmake_switchN]]</B>: explicitly
+	pass switch(es) to dmake</FONT></FONT></P>
+</UL>
+<P>All unknown switches are passed to dmake tool.</P>
+<P>In general, build is used via alias which is created by configure.</P>
+<PRE STYLE="margin-bottom: 0.5cm">alias build=&quot;perl $SOLARENV/bin/build.pl&quot;
</PRE>
+</BODY>
+</HTML>

Propchange: incubator/ooo/ooo-site/trunk/content/tools/tools/build.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/tools/tools/optimizer.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/tools/tools/optimizer.html?rev=1206881&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/tools/tools/optimizer.html (added)
+++ incubator/ooo/ooo-site/trunk/content/tools/tools/optimizer.html Sun Nov 27 22:32:20 2011
@@ -0,0 +1,60 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+<head>
+<meta content=
+"HTML Tidy for Linux/x86 (vers 1st March 2003), see www.w3.org"
+name="generator">
+<meta http-equiv="CONTENT-TYPE" content=
+"text/html; charset=us-ascii">
+<title></title>
+<meta name="GENERATOR" content="StarOffice/5.2 (Win32)">
+<meta name="AUTHOR" content="Vladimir Glazounov">
+<meta name="CREATED" content="20010510;16553080">
+<meta name="CHANGEDBY" content="Vladimir Glazounov">
+<meta name="CHANGED" content="20010510;18034676">
+</head>
+<body>
+<p>Optimizer.pl &#8211; tool for eliminating redundant exported
+symbols.</p>
+<p>Make new optimized .def-file (first step) or make lists of
+unused export symbols (as second step).</p>
+<p>Synopsis:</p>
+<p>perl optimizer.pl [-pro] -c|a</p>
+<p>Description</p>
+<p>-a</p>
+<p>Analyse the stand. This should be used as a first step. New,
+optimized .def files are produced on this step.</p>
+<p>It is recommended when finished this first step to build the
+libraries with modified wnt.mk. If you remove /OPT:NOREF option for
+linker in this file, you'll get fully optimized version of
+libraries (there's no guarantee that it will be working version).
+You get also correspondent .map file. It seems to worth efforts to
+analyse stand again and rebuild libraries, since now some unused
+imported symbols might be thrown away.</p>
+<p>-c</p>
+<p>Compare the lists. This should be used as a first step. On this
+step new .map files and old .map-files are compared and file with
+obsolete symbols is stored in the same directory as .obs, where
+these two are.</p>
+<p>How it works:</p>
+<p>This tool is a Perl script, its functionality is implemented on
+analysis of .def and .map files produced by MS linker cl.exe. It
+must be started from the main directory of the stand with
+options:</p>
+<p>The tool looks for the symbols imported from another libraries
+in correspondent .map files and makes a complete table of used
+symbols (CTS) in memory, than .def file for each library is parsed
+and if there are symbols which are not found in CTS, than they are
+thrown away in new .def file. Former .def file is backed up as
+.olddef if there were no .olddef file before. You get the entire
+list of the libraries and projects to be rebuilt if any new .def
+files were made. There are some symbols which are exported a
+priori, they are:</p>
+<p>component_getDescriptionFunc</p>
+<p>component_getImplementationEnvironment</p>
+<p>component_getFactory</p>
+<p>component_writeInfo</p>
+<p>This table can be enlarged when needed.</p>
+<br>
+</body>
+</html>

Propchange: incubator/ooo/ooo-site/trunk/content/tools/tools/optimizer.html
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message