From: <dan...@us...> - 2006-07-29 14:44:47
|
Revision: 295 Author: dannybackx Date: 2006-07-29 07:44:41 -0700 (Sat, 29 Jul 2006) ViewCVS: http://svn.sourceforge.net/cegcc/?rev=295&view=rev Log Message: ----------- SF.net addresses where possible Modified Paths: -------------- trunk/cegcc/docs/build-toolchain.html trunk/cegcc/docs/using.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-08-05 08:40:41
|
Revision: 306 Author: dannybackx Date: 2006-08-05 01:40:09 -0700 (Sat, 05 Aug 2006) ViewCVS: http://svn.sourceforge.net/cegcc/?rev=306&view=rev Log Message: ----------- Add a Microsoft documentation page to save it from the bitbucket. It is the source of information for a patch by Eric House to the MinGW project which I will be importing soon, I don't want to see the documentation go to waste. As indicated in the README, this is Microsoft's copyrighted material. Added Paths: ----------- trunk/cegcc/docs/microsoft/ trunk/cegcc/docs/microsoft/README trunk/cegcc/docs/microsoft/wincenet_cepcc_app.htm trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/ trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/ceppc01.gif trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/ceppc02.gif trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/ceppc03.gif trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/css.css trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/default.css trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/text.jpg trunk/cegcc/docs/microsoft/wincenet_cepcc_app_data/trans_pixel.asp This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-09-07 21:08:37
|
Revision: 580 http://svn.sourceforge.net/cegcc/?rev=580&view=rev Author: dannybackx Date: 2006-09-07 14:08:31 -0700 (Thu, 07 Sep 2006) Log Message: ----------- Divert the old BerliOS links to SourceForge Modified Paths: -------------- trunk/cegcc/docs/index.html trunk/cegcc/docs/using.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-09-13 19:17:08
|
Revision: 593 http://svn.sourceforge.net/cegcc/?rev=593&view=rev Author: dannybackx Date: 2006-09-13 12:16:58 -0700 (Wed, 13 Sep 2006) Log Message: ----------- Move some of the detailed stuff, which doesn't belong in a "getting started" document, to another file. Modified Paths: -------------- trunk/cegcc/docs/using.html Added Paths: ----------- trunk/cegcc/docs/details.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-09-15 16:44:42
|
Revision: 601 http://svn.sourceforge.net/cegcc/?rev=601&view=rev Author: dannybackx Date: 2006-09-15 09:44:29 -0700 (Fri, 15 Sep 2006) Log Message: ----------- Add a note about installing DLLs. Modified Paths: -------------- trunk/cegcc/docs/index.html Added Paths: ----------- trunk/cegcc/docs/dll.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-10-07 10:05:33
|
Revision: 689 http://svn.sourceforge.net/cegcc/?rev=689&view=rev Author: dannybackx Date: 2006-10-07 03:05:22 -0700 (Sat, 07 Oct 2006) Log Message: ----------- First cut at translating the docs to describe the arm-wince-cegcc and arm-wince-mingw32ce targets instead of the old ones. Modified Paths: -------------- trunk/cegcc/docs/build-toolchain.html trunk/cegcc/docs/choosing.html trunk/cegcc/docs/debugging.html trunk/cegcc/docs/details.html trunk/cegcc/docs/dll.html trunk/cegcc/docs/layer.html trunk/cegcc/docs/using.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-11-03 16:17:19
|
Revision: 775 http://svn.sourceforge.net/cegcc/?rev=775&view=rev Author: dannybackx Date: 2006-11-03 08:17:05 -0800 (Fri, 03 Nov 2006) Log Message: ----------- More accurate documentation. Modified Paths: -------------- trunk/cegcc/docs/build-toolchain.html trunk/cegcc/docs/index.html trunk/cegcc/docs/using.html Modified: trunk/cegcc/docs/build-toolchain.html =================================================================== --- trunk/cegcc/docs/build-toolchain.html 2006-11-03 12:06:13 UTC (rev 774) +++ trunk/cegcc/docs/build-toolchain.html 2006-11-03 16:17:05 UTC (rev 775) @@ -8,11 +8,15 @@ This document describes how to build <A HREF="http://cegcc.sourceforge.net">CeGCC</A>. One chapter deals with building the software on Linux, another focuses on <A HREF="http://cygwin.com">Cygwin</A> (Windows + the Cygnus layer). -<H1>Building on Linux</H1> +<H1>1. Building on Linux</H1> <P> -<H2>Directory structure</H2> +There are two different sets of build scripts for Linux. +The scripts in src/*.sh are being maintained (by Pedro), they can be used unchanged both on +Linux and Cygwin. The scripts in scripts/linux are maintained to build an RPM file, +they are Linux-only. +<H2>1.1. Background information</H2> <P> -<H2>Things to modify</H2> +<H3>1.1.1 Things to modify</H3> <P> Theoretically you should be able to use the scripts and have to modify only the <i>settings.sh</i> script. @@ -30,7 +34,7 @@ The scripts also includes $PREFIX/bin in the path to make sure that the newly built executables can be used by the other scripts in the build process. -<H2>Script concepts</H2> +<H3>1.1.2 Script concepts</H3> <P> All scripts reside in $SCRIPTDIR, that's scripts/linux in your distribution. The build.sh script is the master build script. @@ -41,7 +45,9 @@ There's a small protection : it'll only clean up in $PREFIX if that's equal to /usr/ppc . <P> The tools need to be built in a sequence because they rely on each other. -One of the sequences that works (the one we use) is : +The text below is an overview to make you understand the issues involved, +the real script (scripts/linux/build.sh) is the most +<I>(the only?)</I> reliable source of information on this topic. <ul> <li>binutils <li>includes @@ -62,8 +68,8 @@ Sadly, this conflicts with the concept of e.g. <A HREF="http://www.rpm.org">rpm</A> so it is not possible to create a source RPM for this project in a simple way. -<H2>Hacks to work around problems</H2> -<H3>C++ compiler won't build</H3> +<H3>1.1.3 Hacks to work around problems</H3> +<H4>1.1.3.1 C++ compiler won't build</H4> <P> For some reason, the build process for the C++ compiler chokes. The only explanation - and workaround - that we know of is the one found in @@ -79,12 +85,55 @@ But the build is expected to fail (so the script won't terminate on this occasion), then $BUILD_DIR/gpp/gcc/as is removed (that's the file bothering us), then the build is restarted. -<H1>Building on Cygwin</H1> +<H2>1.2 Building CeGCC for private use</H2> <P> -<H1>Requirements</H1> +This part is very simple : move to the scripts/linux directory and run build.sh . +The software will turn up in /usr/ppc (add /usr/ppc/bin to your PATH) after a while. +<H2>1.3 Building a CeGCC RPM</H2> <P> -<H1>A tour of the directory structure</H1> +To build an RPM for distribution, you'll need to do two things : +<ul> + <li> package the sources in a .tar.gz file + <li> build the RPMs from this +</ul> <P> +You should run scripts/linux/rpm-create-source.sh (from the scripts/linux directory). +This will create a file called <i>/usr/src/RPM/SOURCES/cegcc-src-0.11.tar.gz</i>, +in which the 0.11 part depends on variables sets in <i>settings.sh</i>. +<P> +For this to work, you'll need write permission in <i>/usr/src/RPM/*</i>, +but the next steps also require this. +<P> +To build the RPM, you must run +<i>rpmbuild -ba cegcc.spec</i> +which is another file in the scripts/linux directory. +<P> +You'll need two prerequisites for this to work : +write permissions in /usr/src/RPM, +and you'll have to make sure that the version numbers in +<i>scripts/linux/settings.sh</i> and <i>scripts/linux/cegcc.spec</i> +match. +<H1>2. The portable build - Building on Cygwin and Linux</H1> +<P> +Pedro will probably write documentation on this. +<H1>3. Requirements</H1> +<P> +There is nothing out of the ordinary in the tools you need to build cegcc, +most free software packages require the same : +<ul> + <li> a working C compiler for your platform, only tested with gcc + <li> (the above requirement already assumes binutils) + <li> make + <li> (if you're building an RPM) the rpmbuild tool +</ul> +<P> +You don't need automake, autoconf or such tools : the cegcc sources, +even the ones in SVN, +already contain the files generated by these tools. +Note that we need to do this as some of the software that is part of cegcc +requires different revisions of the auto tools than other parts of cegcc. +<H1>4. A tour of the directory structure</H1> +<P> how to download <P> <pre> Modified: trunk/cegcc/docs/index.html =================================================================== --- trunk/cegcc/docs/index.html 2006-11-03 12:06:13 UTC (rev 774) +++ trunk/cegcc/docs/index.html 2006-11-03 16:17:05 UTC (rev 775) @@ -22,10 +22,11 @@ <LI><A HREF="layer.html">The unix-like layer provided by CeGCC</A></LI> <LI><A HREF="details.html">Details - macros, libraries, ..</A></LI> <LI><A HREF="dll.html">Beware! need to install CeGCC DLL's first</A></LI> -<ul> - <li>CeGCC specifics (predefined macros, libraries)</li> - <li>For the detail-hungry ..</li> -</ul> + <ul> + <li>CeGCC specifics (predefined macros, libraries)</li> + <li>For the detail-hungry ..</li> + </ul> +<LI><A HREF="license.html">License</A></LI> </UL> <P> <h2>Required software</h2> Modified: trunk/cegcc/docs/using.html =================================================================== --- trunk/cegcc/docs/using.html 2006-11-03 12:06:13 UTC (rev 774) +++ trunk/cegcc/docs/using.html 2006-11-03 16:17:05 UTC (rev 775) @@ -87,24 +87,27 @@ <tr><td>arm-wince-cegcc-addr2line</td><td>arm-wince-mingw32ce-addr2line</td><td></td></tr> <tr><td>arm-wince-cegcc-ar</td><td>arm-wince-mingw32ce-ar</td><td>archive library management tool</td></tr> <tr><td>arm-wince-cegcc-as</td><td>arm-wince-mingw32ce-as</td><td>the GNU assembler</td></tr> - <tr><td>arm-wince-cegcc-c++</td><td></td><td>the C++ compiler</td></tr> - <tr><td>arm-wince-cegcc-c++filt</td><td></td><td></td></tr> + <tr><td>arm-wince-cegcc-c++</td><td>arm-wince-mingw32ce-c++</td><td>the C++ compiler</td></tr> + <tr><td>arm-wince-cegcc-c++filt</td><td>arm-wince-mingw32ce-c++filt</td><td></td></tr> <tr><td>arm-wince-cegcc-cpp</td><td>arm-wince-mingw32ce-cpp</td><td>the C preprocessor</td></tr> <tr><td>arm-wince-cegcc-dlltool</td><td>arm-wince-mingw32ce-dlltool</td><td>a tool to create DLLs</td></tr> <tr><td>arm-wince-cegcc-gcc</td><td>arm-wince-mingw32ce-gcc</td><td>the C compiler</td></tr> - <tr><td>arm-wince-cegcc-gcov</td><td>arm-wince-mingw32ce-gcov</td><td></td></tr> - <tr><td>arm-wince-cegcc-gprof</td><td>arm-wince-mingw32ce-gprof</td><td></td></tr> - <tr><td>arm-wince-cegcc-g++</td><td></td><td>the C++ compiler</td></tr> + <tr><td>arm-wince-cegcc-gccbug</td><td>arm-wince-mingw32ce-gccbug</td><td>Bug reporting script for the C compiler</td></tr> + <tr><td>arm-wince-cegcc-gcov</td><td>arm-wince-mingw32ce-gcov</td><td>Test coverage analysis tool</td></tr> + <tr><td>arm-wince-cegcc-gdb</td><td>arm-wince-mingw32ce-gdb</td><td>GNU Debugger</td></tr> + <tr><td>arm-wince-cegcc-gdbtui</td><td>arm-wince-mingw32ce-gdbtui</td><td>GNU Debugger</td></tr> + <tr><td>arm-wince-cegcc-gprof</td><td>arm-wince-mingw32ce-gprof</td><td>Profiling analysis tool</td></tr> + <tr><td>arm-wince-cegcc-g++</td><td>arm-wince-mingw32ce-g++</td><td>the C++ compiler</td></tr> <tr><td>arm-wince-cegcc-ld</td><td>arm-wince-mingw32ce-ld</td><td>the GNU linker</td></tr> <tr><td>arm-wince-cegcc-nm</td><td>arm-wince-mingw32ce-nm</td><td>the tool to inspect symbols in load modules</td></tr> <tr><td>arm-wince-cegcc-objcopy</td><td>arm-wince-mingw32ce-objcopy</td><td></td></tr> <tr><td>arm-wince-cegcc-objdump</td><td>arm-wince-mingw32ce-objdump</td><td>a tool to print data about object files</td></tr> <tr><td>arm-wince-cegcc-ranlib</td><td>arm-wince-mingw32ce-ranlib</td><td>tool to add or refresh the library directory</td></tr> <tr><td>arm-wince-cegcc-readelf</td><td>arm-wince-mingw32ce-readelf</td><td></td></tr> - <tr><td>arm-wince-cegcc-size</td><td>arm-wince-mingw32ce-size</td><td></td></tr> - <tr><td>arm-wince-cegcc-strings</td><td>arm-wince-mingw32ce-strings</td><td></td></tr> - <tr><td>arm-wince-cegcc-strip</td><td>arm-wince-mingw32ce-strip</td><td></td></tr> - <tr><td>arm-wince-cegcc-windres</td><td>arm-wince-mingw32ce-windres</td><td></td></tr> + <tr><td>arm-wince-cegcc-size</td><td>arm-wince-mingw32ce-size</td><td>Print the size of executable contents</td></tr> + <tr><td>arm-wince-cegcc-strings</td><td>arm-wince-mingw32ce-strings</td><td>Print a list of strings in an executable</td></tr> + <tr><td>arm-wince-cegcc-strip</td><td>arm-wince-mingw32ce-strip</td><td>Strip debugging symbols and name tables from an executable</td></tr> + <tr><td>arm-wince-cegcc-windres</td><td>arm-wince-mingw32ce-windres</td><td>Windows resource compiler</td></tr> </table> <H1>How to build a Makefile that works</H1> <p> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-11-03 18:01:06
|
Revision: 777 http://svn.sourceforge.net/cegcc/?rev=777&view=rev Author: dannybackx Date: 2006-11-03 10:00:58 -0800 (Fri, 03 Nov 2006) Log Message: ----------- More documentation Modified Paths: -------------- trunk/cegcc/docs/build-toolchain.html trunk/cegcc/docs/using.html trunk/cegcc/docs/what.html Modified: trunk/cegcc/docs/build-toolchain.html =================================================================== --- trunk/cegcc/docs/build-toolchain.html 2006-11-03 16:17:39 UTC (rev 776) +++ trunk/cegcc/docs/build-toolchain.html 2006-11-03 18:00:58 UTC (rev 777) @@ -121,8 +121,7 @@ There is nothing out of the ordinary in the tools you need to build cegcc, most free software packages require the same : <ul> - <li> a working C compiler for your platform, only tested with gcc - <li> (the above requirement already assumes binutils) + <li> a working C and C++ compiler for your platform, only tested with gcc <li> make <li> (if you're building an RPM) the rpmbuild tool </ul> Modified: trunk/cegcc/docs/using.html =================================================================== --- trunk/cegcc/docs/using.html 2006-11-03 16:17:39 UTC (rev 776) +++ trunk/cegcc/docs/using.html 2006-11-03 18:00:58 UTC (rev 777) @@ -84,11 +84,11 @@ for consistency. <p> <table border=1> - <tr><td>arm-wince-cegcc-addr2line</td><td>arm-wince-mingw32ce-addr2line</td><td></td></tr> + <tr><td>arm-wince-cegcc-addr2line</td><td>arm-wince-mingw32ce-addr2line</td><td>Convert addresses into source program file/line number</td></tr> <tr><td>arm-wince-cegcc-ar</td><td>arm-wince-mingw32ce-ar</td><td>archive library management tool</td></tr> <tr><td>arm-wince-cegcc-as</td><td>arm-wince-mingw32ce-as</td><td>the GNU assembler</td></tr> <tr><td>arm-wince-cegcc-c++</td><td>arm-wince-mingw32ce-c++</td><td>the C++ compiler</td></tr> - <tr><td>arm-wince-cegcc-c++filt</td><td>arm-wince-mingw32ce-c++filt</td><td></td></tr> + <tr><td>arm-wince-cegcc-c++filt</td><td>arm-wince-mingw32ce-c++filt</td><td>C++ name demangler</td></tr> <tr><td>arm-wince-cegcc-cpp</td><td>arm-wince-mingw32ce-cpp</td><td>the C preprocessor</td></tr> <tr><td>arm-wince-cegcc-dlltool</td><td>arm-wince-mingw32ce-dlltool</td><td>a tool to create DLLs</td></tr> <tr><td>arm-wince-cegcc-gcc</td><td>arm-wince-mingw32ce-gcc</td><td>the C compiler</td></tr> @@ -100,10 +100,10 @@ <tr><td>arm-wince-cegcc-g++</td><td>arm-wince-mingw32ce-g++</td><td>the C++ compiler</td></tr> <tr><td>arm-wince-cegcc-ld</td><td>arm-wince-mingw32ce-ld</td><td>the GNU linker</td></tr> <tr><td>arm-wince-cegcc-nm</td><td>arm-wince-mingw32ce-nm</td><td>the tool to inspect symbols in load modules</td></tr> - <tr><td>arm-wince-cegcc-objcopy</td><td>arm-wince-mingw32ce-objcopy</td><td></td></tr> + <tr><td>arm-wince-cegcc-objcopy</td><td>arm-wince-mingw32ce-objcopy</td><td>Copy and manipulate object files</td></tr> <tr><td>arm-wince-cegcc-objdump</td><td>arm-wince-mingw32ce-objdump</td><td>a tool to print data about object files</td></tr> <tr><td>arm-wince-cegcc-ranlib</td><td>arm-wince-mingw32ce-ranlib</td><td>tool to add or refresh the library directory</td></tr> - <tr><td>arm-wince-cegcc-readelf</td><td>arm-wince-mingw32ce-readelf</td><td></td></tr> + <tr><td>arm-wince-cegcc-readelf</td><td>arm-wince-mingw32ce-readelf</td><td>Not very useful, we don't produce ELF files</td></tr> <tr><td>arm-wince-cegcc-size</td><td>arm-wince-mingw32ce-size</td><td>Print the size of executable contents</td></tr> <tr><td>arm-wince-cegcc-strings</td><td>arm-wince-mingw32ce-strings</td><td>Print a list of strings in an executable</td></tr> <tr><td>arm-wince-cegcc-strip</td><td>arm-wince-mingw32ce-strip</td><td>Strip debugging symbols and name tables from an executable</td></tr> Modified: trunk/cegcc/docs/what.html =================================================================== --- trunk/cegcc/docs/what.html 2006-11-03 16:17:39 UTC (rev 776) +++ trunk/cegcc/docs/what.html 2006-11-03 18:00:58 UTC (rev 777) @@ -58,6 +58,25 @@ <a href="choosing.html">Choosing in which environment to develop</a>. <h1>The Linux based distribution</h1> <p> +Your best option to start using CeGCC on Linux is to download the RPM. +You can download from +<a href="http://sourceforge.net/project/showfiles.php?group_id=173455">the +SourceForge download page for CeGCC</a>, +your best bet is the latest distribution. +You'll find that an RPM distribution is (at the time of this writing) +slightly larger than 40 MB. +<p> +After completing the download, all you have to do is install it, +using a command such as : +<pre> +rpm -i --nodeps cegcc-0.11-1.i586.rpm +</pre> +The --nodeps argument is sometimes necessary, I'm not sure why. +<p> +After that, all the commands should be available under /usr/ppc as described +in the rest of this documentation. <h1>The Cygwin based distribution</h1> +<p> +To be written. </body> </html> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2006-12-30 10:26:40
|
Revision: 850 http://svn.sourceforge.net/cegcc/?rev=850&view=rev Author: dannybackx Date: 2006-12-30 02:26:39 -0800 (Sat, 30 Dec 2006) Log Message: ----------- Document more of the stuff I learned about starting up and terminating WinCE apps while researching profiling. Modified Paths: -------------- trunk/cegcc/docs/index.html trunk/cegcc/docs/profile.html Modified: trunk/cegcc/docs/index.html =================================================================== --- trunk/cegcc/docs/index.html 2006-12-30 10:21:39 UTC (rev 849) +++ trunk/cegcc/docs/index.html 2006-12-30 10:26:39 UTC (rev 850) @@ -26,6 +26,12 @@ <li>CeGCC specifics (predefined macros, libraries)</li> <li>For the detail-hungry ..</li> </ul> +<LI><A HREF="profile.html">Profiling and test coverage support</A></LI> + <ul> + <li><A HREF="profile.html#getting started">Getting started</A></li> + <li><A HREF="profile.html#technical overview">Technical overview</A></li> + <li><A HREF="profile.html#start and terminate">Startup and termination of WinCE programs</A></li> + </ul> <LI><A HREF="license.html">License</A></LI> </UL> <P> Modified: trunk/cegcc/docs/profile.html =================================================================== --- trunk/cegcc/docs/profile.html 2006-12-30 10:21:39 UTC (rev 849) +++ trunk/cegcc/docs/profile.html 2006-12-30 10:26:39 UTC (rev 850) @@ -18,7 +18,9 @@ <A HREF="http://korea.gnu.org/manual/release/gcov/gcov_1.html">gcov</A> for their description. </P> +<A NAME="getting started"> <H1>1. Getting started</H1> +</A> The examples are also in the CeGCC source tree in directories <A HREF="http://cegcc.svn.sourceforge.net/viewvc/cegcc/trunk/cegcc/docs/examples/coverage">docs/examples/coverage</A> @@ -313,8 +315,12 @@ were executed. Modify <i>m1.c</i> so fibo() is called fewer times, and you'll see more modest numbers. +<A NAME="technical overview"> <H1>2 Technical overview : CeGCC (gcc) profiling and coverage support</H1> +</A> <P> +This piece of documentation is not strictly related to profiling and test coverage support, +the normal operation is also described. <H2>2.1 Overview</H2> <P> The tables below present an overview of how this all works, @@ -410,7 +416,9 @@ rather the compiler generates a call to _gcov_init from all compiled source files. The support functions are in <i>src/gcc/gcc/libgcov.c</i> and <i>src/gcc/gcc/gcov-io.c</i>. +<A NAME="start and terminate"> <H2>2.4 Ways in which WinCE applications start and terminate</H2> +</A> <H3>2.4.1 Startup</H3> <H4>2.4.1.1 main</H4> <P> @@ -430,10 +438,57 @@ (see the previous paragraph), the main.o is simply not used. The source for <i>main.o</i> is in <b>src/newlib/newlib/libc/sys/wince/main.c</b>. <H3>2.4.2 Termination</H3> -<H4>2.4.2.1 WinMain PostQuitMessage</H4> -<H4>2.4.2.2 WinMain fall through</H4> -<H4>2.4.2.3 WinMain WM_DESTROY</H4> -<H4>2.4.2.4 exit</H4> -<H4>2.4.2.5 main fall through</H4> +<P> +This chapter describes the various ways in which a Windows CE application can terminate. +<H4>2.4.2.1 WinMain WM_DESTROY</H4> +<P> +The <i>WM_DESTROY</i> message is sent to an application by the system +e.g. when the user hits the button to close that window. +The typical response of an application is to call <i>PostQuitMessage</i>. +<H4>2.4.2.2 WinMain PostQuitMessage</H4> +<P> +The <i>PostQuitMessage</i> function posts a request to terminate this thread or application. +It does so by sending a <i>WM_QUIT</i> message to the thread or application. +<P> +In response to <i>WM_QUIT</i>, the normal message loop will terminate. +<PRE> + BOOL r; + + while ((r = GetMessageW(&msg, wnd, 0, 0)) != 0) { + if (r != -1) { + TranslateMessage(&msg); + DispatchMessageW(&msg); + } else { + // Handle the error + } + } +</PRE> +<P> +This is implemented in the <i>GetMessageW</i> function : +when the function receives the WM_QUIT message, its return value is 0. +<H4>2.4.2.3 exit</H4> +<H5>2.4.2.3.1 arm-wince-cegcc exit</H5> +<P> +In our <i>arm-wince-cegcc</i> target, this is implemented in the system layer of newlib. +Startup and termination are both coded in <i>src/newlib/newlib/libc/sys/wince/startup.c</i>. +<P> +The <i>exit</i> function +(part of the stdlib part of newlib, in <i>src/newlib/newlib/libc/stdlib/</i>) +does little more than calling <i>_exit</i>. +The latter function jumps back into the <i>_startup_</i> function by using <i>longjmp</i> +and performs newlib cleanup, +and finally calls <i>ExitProcess</i> which is a Windows CE System Call. +<H5>2.4.2.3.2 arm-wince-mingw32ce exit</H5> +<P> +In our <i>arm-wince-mingw32ce</i> target, +exit is implemented in <i>src/mingw/atexit.c</i>. +It calls a cleanup function and <i>ExitProcess</i>. +<H4>2.4.2.4 WinMain / main fall through</H4> +<P> +On <i>arm-wince-cegcc</i>, falling through the end of <i>main</i> +gets us to the same place where calling <i>exit</i> leads to. +On <i>arm-wince-mingw32ce</i>, this is not true, +but the startup function (<i>WinMainCRTStartup</i>, +e.g. in <i>src/mingw/crt3.c</i>) calls the same functions as <i>exit</i>. </BODY> </HTML> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2007-06-13 20:09:30
|
Revision: 947 http://svn.sourceforge.net/cegcc/?rev=947&view=rev Author: dannybackx Date: 2007-06-13 13:09:19 -0700 (Wed, 13 Jun 2007) Log Message: ----------- Try getting all of this in better shape. Comments welcome. Modified Paths: -------------- trunk/cegcc/docs/build-toolchain.html trunk/cegcc/docs/choosing.html trunk/cegcc/docs/debugging.html trunk/cegcc/docs/details.html trunk/cegcc/docs/dll.html trunk/cegcc/docs/index.html trunk/cegcc/docs/install-linux.html trunk/cegcc/docs/layer.html trunk/cegcc/docs/license.html trunk/cegcc/docs/profile.html trunk/cegcc/docs/structure.html trunk/cegcc/docs/using.html trunk/cegcc/docs/what.html Modified: trunk/cegcc/docs/build-toolchain.html =================================================================== --- trunk/cegcc/docs/build-toolchain.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/build-toolchain.html 2007-06-13 20:09:19 UTC (rev 947) @@ -131,7 +131,9 @@ <H3>1.4.3 </H3> <H1>2. Building on Cygwin</H1> <P> -To be written by someone who knows about Cygwin... +The scripts <i>build-cegcc.sh</i> and <i>build-mingw32ce.sh</i> +work on Cygwin in the same way as they do on Linux. +<p> <A NAME="#common"><H1>3 Platform independent information</H1></A> <H2>3.1 How the scripts interact</H2> <H2>3.2 Installation directory</H2> @@ -260,5 +262,24 @@ directories prior to using the build scripts. The build tends to be less reliable if part of an old build is still present. <H2>6.3 </H2> + </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/choosing.html =================================================================== --- trunk/cegcc/docs/choosing.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/choosing.html 2007-06-13 20:09:19 UTC (rev 947) @@ -6,26 +6,51 @@ <img src="../images/banner1.png" alt="CeGCC cross compiler for PocketPC"> <h1>Choosing in which environment to develop</h1> <p> - <h2>A Unix-like application</h2> + Remember that <i>arm-wince-cegcc</i> implements a unix-like layer on top of Windows CE, + and that <i>arm-wince-mingw32ce</i> implements the native CE API. <p> - <h2>Use only the Windows CE API</h2> + <b>Our recommendation is to use the <i>arm-wince-mingw32ce</i> toolset whenever possible</b> + because the newlib-based unix-like layer that <i>arm-wince-cegcc</i> implements is + incomplete (it's newlib, not glibc) and sometimes confusing and incompatible with coredll. <p> - <h2>Choosing in which environment to develop</h2> + On the other hand, <i>arm-wince-mingw32ce</i> offers more complete C++ DLL support. + We will probably implement a C++ DLL for the <i>arm-wince-mingw32ce</i> environment shortly. + <h2>1. Porting a Unix-like application</h2> <p> + <i>Arm-wince-cegcc</i> is a great tool to start porting your application to WinCE, + as it offers a unix-like layer on top of the Windows CE API. + <p> + This doesn't come without risks though (it is very easy to mix up stdio API's + from coredll and newlib, and they're incompatible). + Also be aware that Windows CE has many Unicode based system calls, + you'll have to make sure your application can deal with that. + <h2>2. Porting an application that uses only the Windows CE API</h2> + <p> + It should be abundantly clear that the right tool for this job is the <i>arm-wince-mingw32ce</i> + toolset. + <h2>3. Recompiling a CE application that was built with Embedded Visual C++</h2> + <p> <p>If you want to build an existing Windows CE application that already - builds with eVC or MSVC, or you want to develop a Windows CE application that - only depends on the Win32 API and the limited libc support coredll.dll (the - native runtime) offers, then what you want is mingw32ce.</p> - <p>If you want to port an application that depends on a more complete c runtime, - the cegcc toolchain will be a better environment. Cegcc offers unified - file descriptors, (in-process only) signals, (TODO: to be completed).</p> - <h2>Microsoft environment equivalents</h2> + builds with eVC, then you probably think you're not porting an application. + <p> + The right tool to use is <i>arm-wince-mingw32ce</i>, + but you need to be aware that some of the C or C++ extensions supported by + eVC aren't available in our toolset. + <h2>4. Porting an application that was built with MicroSoft Visual C++</h2> + <p> + <p>An application that is built not with eVC but MSVC (MicroSoft Visual C++) + is not typically a Windows CE but a Windows application. + This may be an issue because Windows CE supports only a limited subset of + the Windows API. + <p> + Once more, the right tool to use is <i>arm-wince-mingw32ce</i>. + <h2>5. Microsoft environment equivalents</h2> <p>The <b>/ENTRY</b> option to the Microsoft compiler is equivalent to ld's <b>-e</b> option.</P> - <h2>Console Applications</h2> + <h2>6. Console Applications</h2> <h>In the NT/9x target versions of Microsoft's tools, there is have some - default behaviour, such as <i>if main is defined then CONSOLE subsytem is the - default</i>. + default behaviour, such as + <i>if main is defined then CONSOLE subsytem is the default</i>. <p>Windows CE applications don't have that functionality, as they must always specify the Windows CE subsystem: <a href="http://msdn2.microsoft.com/en-us/library/fcc1zstk.aspx"> http://msdn2.microsoft.com/en-us/library/fcc1zstk.aspx</a> <p>If you want to develop a console based application, take a look at Pocket @@ -34,4 +59,22 @@ one, a default one will be linked in that will call the standard int main (int argc, char** argv) with argc and argv properly filled.</p> </body> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </html> Modified: trunk/cegcc/docs/debugging.html =================================================================== --- trunk/cegcc/docs/debugging.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/debugging.html 2007-06-13 20:09:19 UTC (rev 947) @@ -8,6 +8,7 @@ did with the cross-debugger that's part of the <font color="red"><b>0.02</b></font> binary pre-release of cegcc. +(Don't worry about the old version number, all of this is still valid.) <p> I've annotated it slightly. My input is in <font color="green"><i>green italic</i></font>, @@ -315,4 +316,22 @@ </pre> </p> </body> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </html> Modified: trunk/cegcc/docs/details.html =================================================================== --- trunk/cegcc/docs/details.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/details.html 2007-06-13 20:09:19 UTC (rev 947) @@ -222,4 +222,22 @@ dannypc: {74} </pre> </body> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </html> Modified: trunk/cegcc/docs/dll.html =================================================================== --- trunk/cegcc/docs/dll.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/dll.html 2007-06-13 20:09:19 UTC (rev 947) @@ -5,13 +5,18 @@ </HEAD> <BODY> <P> -CeGCC ships with three DLL files. -You can find them at +Depending on the package you're using, CeGCC ships with a different number of DLL files. +The <i>arm-wince-cegcc</i> distribution has three DLLs : <PRE> -/usr/ppc/arm-wince-cegcc/lib/device/cegcc.dll -/usr/ppc/arm-wince-cegcc/lib/device/cegccthrd.dll -/usr/ppc/arm-wince-cegcc/lib/device/libstdc++.dll +/opt/cegcc/arm-wince-cegcc/lib/device/cegcc.dll +/opt/cegcc/arm-wince-cegcc/lib/device/cegccthrd.dll +/opt/cegcc/arm-wince-cegcc/lib/device/libstdc++.dll </PRE> +the <i>arm-wince-mingw32ce</i> distribution currently only has one DLL : +<PRE> +/opt/mingw32ce/arm-wince-mingw32ce/bin/mingwm10.dll +</PRE> +Note that these absolute file names are the ones found in the RPM images that we distribute. <P> The good thing about those DLLs is they allow you to create smaller and more efficient applications. @@ -23,7 +28,7 @@ that this application or a part of it was not found. No reference to which DLL you're missing. <P> -The DLLs which we ship in <i>/usr/ppc/arm-wince-cegcc/lib/device</i> +The DLLs which we ship in <i>/opt/cegcc/arm-wince-cegcc/lib/device</i> are stripped version, meant to be installed on your PDA. In the directory above, files of the same name (but bigger) exist. They are unstripped versions (they still contain named symbol definitions), @@ -32,9 +37,28 @@ Depending on the tools available to you, you will want to run commands such as <PRE> -pcp /usr/ppc/arm-wince-cegcc/lib/device/cegcc.dll /windows/cegcc.dll -pcp /usr/ppc/arm-wince-cegcc/lib/device/cegccthrd.dll /windows/cegccthrd.dll -pcp /usr/ppc/arm-wince-cegcc/lib/device/libstdc++.dll /windows/libstdc++.dll +pcp /opt/cegcc/arm-wince-cegcc/lib/device/cegcc.dll :/windows/cegcc.dll +pcp /opt/cegcc/arm-wince-cegcc/lib/device/cegccthrd.dll :/windows/cegccthrd.dll +pcp /opt/cegcc/arm-wince-cegcc/lib/device/libstdc++.dll :/windows/libstdc++.dll +pcp /opt/mingw32ce/arm-wince-mingw32ce/bin/mingwm10.dll :/windows/mingwm10.dll </PRE> </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/index.html =================================================================== --- trunk/cegcc/docs/index.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/index.html 2007-06-13 20:09:19 UTC (rev 947) @@ -41,4 +41,22 @@ functionality is part of ActiveSync, which usually ships with your PDA. On linux, the RAPI implementation is provided by the <a href="http://synce.sourceforge.net">SynCE</a> project.</p> </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/install-linux.html =================================================================== --- trunk/cegcc/docs/install-linux.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/install-linux.html 2007-06-13 20:09:19 UTC (rev 947) @@ -44,23 +44,27 @@ You can install the CeGCC RPM just like any other one, by using the <pre> - rpm -i cegcc-0.09-2.i586.rpm + rpm -i cegcc-cegcc-0.15-1.i586.rpm + rpm -i cegcc-mingw32ce-0.15-1.i586.rpm </pre> command. +You'll need to be the superuser (root) for this to work. For unknown reasons, the RPM sometimes asks for the <i>libiconv</i> to be installed first. A workaround is to use the --nodeps option : <pre> - rpm -i --nodeps cegcc-0.09-2.i586.rpm + rpm -i --nodeps cegcc-cegcc-0.15-1.i586.rpm </pre> <p> After a successful installation, all of CeGCC can be found under the -<i>/usr/ppc</i> directory tree. +<i>/opt/cegcc</i> and +<i>/opt/mingw32ce</i> directory trees. <h2>How do you use the release ?</h2> <p> To start using CeGCC, you'll have to put -the directory <i>/usr/ppc/bin</i> in your path, e.g. like this : +the directories <i>/opt/cegcc/bin</i> and/or +<i>/opt/mingw32ce/bin</i> in your path, e.g. like this : <pre> - export PATH=$PATH:/usr/ppc/bin + export PATH=$PATH:/opt/cegcc/bin:/opt/mingw32ce/bin </pre> <p> To make this permanent, you'll want to apply such a change to your login environment, @@ -124,43 +128,24 @@ <H2>Known problems</H2> <P> None that we care to mention here. -<!-- - - Button row at the top of the page. - - --> -<table bgcolor="blue" border="6"> <tr> - <td bgcolor="#CCCC00" > <font size="+2" color="#222200"> - <a href="http://cegcc.sf.net/docs/index.html"> - Documentation - </a> - </font> </td> - <td bgcolor="#CCCC00" > <font size="+2" color="#222200"> - <a href="http://svn.sourceforge.net/cegcc"> - SVN Repository - </a> - </font> </td> - <td bgcolor="#CCCC00" > <font size="+2" color="#222200"> - <a href="http://sf.net/projects/cegcc"> - Project page on SourceForge - </a> - </font> </td> - <td bgcolor="#CCCC00" > <font size="+2" color="#222200"> - <a href="http://sf.net/project/showfiles.php?group_id=173455"> - Download - </a> - </font> </td> - <td bgcolor="#CCCC00" > <font size="+2" color="#222200"> - <a href="install-linux.html"> - Installation on Linux - </a> - </font> </td> -</tr></table> -<!-- - - End of the button row - - --> </p> </body> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </html> Modified: trunk/cegcc/docs/layer.html =================================================================== --- trunk/cegcc/docs/layer.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/layer.html 2007-06-13 20:09:19 UTC (rev 947) @@ -43,8 +43,23 @@ to either the current directory from the parent process, or the path extracted from the executable file we're running. Similarly a PATH variable is also put in the environment. -<p> -More information about this is in -<a href="layer.html">The unix-like layer provided by CeGCC</a>. </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/license.html =================================================================== --- trunk/cegcc/docs/license.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/license.html 2007-06-13 20:09:19 UTC (rev 947) @@ -56,4 +56,22 @@ <li><a href="http://www.gnu.org/licenses/gpl-faq.html">GPL FAQ</a> </ul> </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/profile.html =================================================================== --- trunk/cegcc/docs/profile.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/profile.html 2007-06-13 20:09:19 UTC (rev 947) @@ -491,4 +491,22 @@ but the startup function (<i>WinMainCRTStartup</i>, e.g. in <i>src/mingw/crt3.c</i>) calls the same functions as <i>exit</i>. </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/structure.html =================================================================== --- trunk/cegcc/docs/structure.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/structure.html 2007-06-13 20:09:19 UTC (rev 947) @@ -87,4 +87,22 @@ <P> Current versions of Windows CE use coredll.dll instead. </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/using.html =================================================================== --- trunk/cegcc/docs/using.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/using.html 2007-06-13 20:09:19 UTC (rev 947) @@ -309,6 +309,47 @@ Note that the <i>arm-wince-cegcc</i> target has different characteristics than <i>arm-wince-mingw32ce</i> target. The <errno.h> file is an example of such a difference : -it does exist, and works, in <i>arm-wince-cegcc<i/>. +it does exist, and works, in <i>arm-wince-cegcc</i>. +<h2>Mixing coredll.dll and cegcc stdio</h2> +<p> +When you're using the <i>arm-wince-cegcc</i> tools, +the unix-like layer kicks in : +the <i>cegcc.dll</i> library provides you with all of +<a href="http://sources.redhat.com/newlib/">newlib</a>, +a library originally written to offer a cheap C library for embedded environments. +<p> +Newlib comes with its own implementation of <i>stdio</i>, +functions like <i>fopen</i>, <i>fprintf</i>, <i>fclose</i>, <i>scanf</i>, <i>printf</i>, +and many more. +<p> +The trouble is that coredll.dll, +Windows CE's runtime library, also comes with these functions, +and the two libraries are incompatible with each other. +<p> +Getting in trouble with this is not all that easy, so we hope you don't go down this road. +Should you ever find yourself in a position where you find that stdio functions mysteriously +fail on you, then think about this. +The way to figure out which functions your application is using is +to use the <i>arm-wince-cegcc-objdump</i> utility. +It'll tell you from which library each function is obtained. +All of stdio should come from the same library. </BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </HTML> Modified: trunk/cegcc/docs/what.html =================================================================== --- trunk/cegcc/docs/what.html 2007-06-13 19:52:22 UTC (rev 946) +++ trunk/cegcc/docs/what.html 2007-06-13 20:09:19 UTC (rev 947) @@ -69,14 +69,32 @@ After completing the download, all you have to do is install it, using a command such as : <pre> -rpm -i --nodeps cegcc-0.11-1.i586.rpm +rpm -i --nodeps cegcc-cegcc-0.14-1.i586.rpm </pre> The --nodeps argument is sometimes necessary, I'm not sure why. <p> -After that, all the commands should be available under /usr/ppc as described +After that, all the commands should be available under /opt/cegcc or /opt/mingw32ce as described in the rest of this documentation. <h1>The Cygwin based distribution</h1> <p> To be written. </body> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + </ul> + </td> +</tr></table> </html> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <dan...@us...> - 2007-06-18 18:59:40
|
Revision: 968 http://svn.sourceforge.net/cegcc/?rev=968&view=rev Author: dannybackx Date: 2007-06-18 11:59:38 -0700 (Mon, 18 Jun 2007) Log Message: ----------- Add a page that describes which info to send along when asking us questions. Modified Paths: -------------- trunk/cegcc/docs/build-toolchain.html trunk/cegcc/docs/choosing.html trunk/cegcc/docs/debugging.html trunk/cegcc/docs/details.html trunk/cegcc/docs/dll.html trunk/cegcc/docs/index.html trunk/cegcc/docs/install-linux.html trunk/cegcc/docs/layer.html trunk/cegcc/docs/license.html trunk/cegcc/docs/profile.html trunk/cegcc/docs/structure.html trunk/cegcc/docs/using.html trunk/cegcc/docs/what.html Added Paths: ----------- trunk/cegcc/docs/reporting.html Modified: trunk/cegcc/docs/build-toolchain.html =================================================================== --- trunk/cegcc/docs/build-toolchain.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/build-toolchain.html 2007-06-18 18:59:38 UTC (rev 968) @@ -279,6 +279,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/choosing.html =================================================================== --- trunk/cegcc/docs/choosing.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/choosing.html 2007-06-18 18:59:38 UTC (rev 968) @@ -76,6 +76,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/debugging.html =================================================================== --- trunk/cegcc/docs/debugging.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/debugging.html 2007-06-18 18:59:38 UTC (rev 968) @@ -331,6 +331,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/details.html =================================================================== --- trunk/cegcc/docs/details.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/details.html 2007-06-18 18:59:38 UTC (rev 968) @@ -237,6 +237,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/dll.html =================================================================== --- trunk/cegcc/docs/dll.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/dll.html 2007-06-18 18:59:38 UTC (rev 968) @@ -58,6 +58,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/index.html =================================================================== --- trunk/cegcc/docs/index.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/index.html 2007-06-18 18:59:38 UTC (rev 968) @@ -33,6 +33,7 @@ <li><A HREF="profile.html#start and terminate">Startup and termination of WinCE programs</A></li> </ul> <LI><A HREF="license.html">License</A></LI> +<LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </UL> <P> <h2>Required software</h2> @@ -56,6 +57,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/install-linux.html =================================================================== --- trunk/cegcc/docs/install-linux.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/install-linux.html 2007-06-18 18:59:38 UTC (rev 968) @@ -160,6 +160,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/layer.html =================================================================== --- trunk/cegcc/docs/layer.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/layer.html 2007-06-18 18:59:38 UTC (rev 968) @@ -59,6 +59,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/license.html =================================================================== --- trunk/cegcc/docs/license.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/license.html 2007-06-18 18:59:38 UTC (rev 968) @@ -71,6 +71,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/profile.html =================================================================== --- trunk/cegcc/docs/profile.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/profile.html 2007-06-18 18:59:38 UTC (rev 968) @@ -506,6 +506,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Added: trunk/cegcc/docs/reporting.html =================================================================== --- trunk/cegcc/docs/reporting.html (rev 0) +++ trunk/cegcc/docs/reporting.html 2007-06-18 18:59:38 UTC (rev 968) @@ -0,0 +1,48 @@ +<HTML> +<HEAD> +<TITLE>Information to including when asking help or when reporting problems</TITLE> +<img src="../images/banner1.png" alt="CeGCC cross compiler for PocketPC"> +</HEAD> +<BODY> +<H1>Information to including when asking help or when reporting problems</H1> +<P> +When you ask questions on +<a href="mailto:ceg...@li...">the mailing list</a>, +or when you report a problem (either on the mailing list or via +<a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514">the bug tracker</a>, +you can help us out by giving as much hard information as you can. +<P> +Tell us which version of our software you're using : +<ul> + <li> installed from source (which version? a specific distribution, or from SVN) + <li> installed from a binary distribution ? Which one ? +</ul> +<P> +But also whether you're using <i>arm-wince-mingw32ce</i> or <i>arm-wince-cegcc</i> tools. +<P> +Which platform are you using to develop ? (Linux, Cygwin, ..) +<P> +What is the nature of your problem ? +<P> +Can you send us a small source that demonstrates the problem ? +</BODY> +<table border=0 cellspacing=10 width="100%"> <tr> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Information</h2> + <ul> + <li> <a href="http://cegcc.sourceforge.net"> CeGCC Home Page on SourceForge </a> + <li> <a href="index.html"> CeGCC Documentation </a> + <li> <a href="http://sourceforge.net/projects/cegcc"> Project page on SourceForge </a> + <li> <a href="http://cegcc.wiki.sourceforge.net"> CeGCC wiki </a> + </ul> + </td> + <td align=left valign=top bgcolor="#ededed" width="50%"> + <h2 align=center>Support</h2> + <ul> + <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. + <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> + </ul> + </td> +</tr></table> +</HTML> Property changes on: trunk/cegcc/docs/reporting.html ___________________________________________________________________ Name: svn:eol-style + native Modified: trunk/cegcc/docs/structure.html =================================================================== --- trunk/cegcc/docs/structure.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/structure.html 2007-06-18 18:59:38 UTC (rev 968) @@ -102,6 +102,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/using.html =================================================================== --- trunk/cegcc/docs/using.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/using.html 2007-06-18 18:59:38 UTC (rev 968) @@ -349,6 +349,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> Modified: trunk/cegcc/docs/what.html =================================================================== --- trunk/cegcc/docs/what.html 2007-06-17 18:14:24 UTC (rev 967) +++ trunk/cegcc/docs/what.html 2007-06-18 18:59:38 UTC (rev 968) @@ -94,6 +94,7 @@ <ul> <li> <a href="mailto:ceg...@li...">Questions ? Use the mailing list</a>. <li> <a href="http://sourceforge.net/tracker/?group_id=173455&atid=865514"> CeGCC Bug tracker </a> + <LI><A HREF="reporting.html">Information to including when asking help or when reporting problems</A></LI> </ul> </td> </tr></table> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |