source: rtems/doc/porting/porting.texi @ 110445c

4.104.114.84.95
Last change on this file since 110445c was 110445c, checked in by Joel Sherrill <joel.sherrill@…>, on 06/10/00 at 19:41:09

Patch rtems-rc-4.5.0-21.diff from Ralf Corsepius <corsepiu@…>
which splits the current monolithic specs files into a sequence of
subparts. These can be concatenated togather to make a the whole .spec
file. This cleans up the maintenance problem of having "all languages"
and a "C/C++ only" gccnewlib spec files. Plus it should make it easier
to produce variants like the gdb-m68k-bdm which require special hackery. :)
Ralf's comments:

It addresses the way *.spec.in get composed inside of the source
tree.

Changes:

  • Each spec.in is broken into several files (*.add), one *.add file per sub-package.
  • Each Makefile.am composes spec.ins from the *.add files
  • Removal of redundant automake support files.
  • Default value for BuildRoot? changed to /tmp/<spec-file-name>
  • %clean stage added to *specs

Advantages (IMHO).

  • The *.add files are easier to adminstrate and more flexible in comparison to the former *.specs.ins.
  • gccnewlib_c_only.spec.in now is composed from the same sources as gccnewlib.spec.in (less errors)
  • If using the default BuildRoot? --clean now deletes all files that were generated while building.

Notes:

  • rtems.spec.in has not yet been adapted to the scheme used for the other *spec.ins
  • Except for cosmetical changes the internals of the *.spec files should not have changed.

To Apply:

cvs rm -f scripts/binutils/binutils.spec.in
cvs rm -f scripts/gccnewlib/gccnewlib.spec.in
cvs rm -f scripts/gccnewlib/gccnewlib_c_only.spec.in
cvs rm -f scripts/gdb/gdb.spec.in
cvs rm -f scripts/config.sub
cvs rm -f scripts/config.guess
cvs rm -f scripts/install-sh
cvs rm -f scripts/mkinstalldirs
cvs rm -f scripts/missing

patch -p1 < rtems-rc-4.5.0-21.diff

cvs add scripts/*/*.add
cvs add scripts/*/README

  • Property mode set to 100644
File size: 2.6 KB
Line 
1\input texinfo   @c -*-texinfo-*-
2@c %**start of header
3@setfilename porting
4@syncodeindex vr fn
5@synindex ky cp
6@paragraphindent 0
7@c @smallbook
8@c %**end of header
9
10@c
11@c  COPYRIGHT (c) 1988-1999.
12@c  On-Line Applications Research Corporation (OAR).
13@c  All rights reserved.
14@c
15@c  $Id$
16@c
17
18@c
19@c   Master file for the Porting Guide
20@c
21
22@c Joel's Questions
23@c
24@c  1.  Why does paragraphindent only impact makeinfo?
25@c  2.  Why does paragraphindent show up in HTML?
26@c
27
28@include version.texi
29@include common/setup.texi
30
31@ifset use-ascii
32@dircategory RTEMS On-Line Manual
33@direntry
34* RTEMS Porting Guide: (porting).      The Porting Guide
35@end direntry
36@end ifset
37
38@c variable substitution info:
39@c
40@set is-C
41@clear is-Ada
42@set LANGUAGE C
43@set STRUCTURE structure
44@set ROUTINE function
45@set OR |
46@set RPREFIX RTEMS_
47@set DIRPREFIX rtems_
48@c the language is @value{LANGUAGE}
49@c NOTE:  don't use underscore in the name
50@c
51
52@c
53@c  Title Page Stuff
54@c
55
56
57
58
59
60
61@c
62@c  I don't really like having a short title page.  --joel
63@c
64@c @shorttitlepage RTEMS Porting Guide
65
66@setchapternewpage odd
67@settitle RTEMS Porting Guide
68@titlepage
69@finalout
70
71@title RTEMS Porting Guide
72@subtitle Edition @value{EDITION}, for RTEMS @value{VERSION}
73@sp 1
74@subtitle @value{UPDATED}
75@author On-Line Applications Research Corporation
76@page
77@include common/cpright.texi
78@end titlepage
79
80@c  This prevents a black box from being printed on "overflow" lines.
81@c  The alternative is to rework a sentence to avoid this problem.
82
83@include preface.texi
84@include developtools.texi
85@include sourcecode.texi
86@include cpumodels.texi
87@include cpuinit.texi
88@include interrupts.texi
89@include taskcontext.texi
90@include idlethread.texi
91@include prioritybitmap.texi
92@include codetuning.texi
93@include miscellaneous.texi
94@ifinfo
95@node Top, Preface, (dir), (dir)
96@top porting
97
98This is the online version of the RTEMS Porting Guide.
99
100@menu
101* Preface::
102* Development Tools::
103* Source Code Organization::
104* CPU Model Variations::
105* CPU Initialization::
106* Interrupts::
107* Task Context Management::
108* IDLE Thread::
109* Priority Bitmap Manipulation::
110* Code Tuning Parameters::
111* Miscellaneous::
112* Command and Variable Index::
113* Concept Index::
114@end menu
115
116@end ifinfo
117@c
118@c
119@c Need to copy the emacs stuff and "trailer stuff" (index, toc) into here
120@c
121
122@node Command and Variable Index, Concept Index, Miscellaneous Endian Swap Unsigned Integers, Top
123@unnumbered Command and Variable Index
124
125There are currently no Command and Variable Index entries.
126
127@c @printindex fn
128
129@node Concept Index, , Command and Variable Index, Top
130@unnumbered Concept Index
131
132There are currently no Concept Index entries.
133@c @printindex cp
134
135@contents
136@bye
137
Note: See TracBrowser for help on using the repository browser.