473,466 Members | 1,377 Online
Bytes | Software Development & Data Engineering Community
Create Post

Home Posts Topics Members FAQ

Any authoritative reference on structuring (large-scale) projects?

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.

If such a thing doesn't exist, then would someone with enough name
recognition to have an influence please decree such a guideline. I'd be
happy to simply be able to say my project is organized in accordance with
the [place name here] recommendation.

The KDE has an approach, so does Mozilla, I trust GNOME also has some kind
of proscribed structure. Perhaps my best bet is to examine these projects
and select what I find useful from each. I would like to have some sense
that my projects are organized in such a way as to be readily understood by
other programmers who share widely accepted conventions. I also want my
work to integrate smoothely with other people's.

I'm a firm believer in the idea that even the smallest project should
conform to extensible conventions. I want to get in the habit of doing
things right, but I don't really know what right is.

Stroustrup provides some discussion of these issues in the final chapters of
TC++PL(SE). Have his recommendations been adopted by a large number of
programmers? I have not yet read the chapters. Are they thorough enough to
provide a solid foundation for organizing a large-scale project?

Maven is something I am aware of form a past life:

http://maven.apache.org/

It's actually a bit too broadly focused for my purposes. I'm only
presenting it as an example of the kind of thing I'm looking for.
--
p->m == (*p).m == p[0].m
http://www.kdevelop.org
http://www.suse.com
http://www.mozilla.org
Jul 22 '05 #1
14 1833
Steven T. Hatton wrote:
<snip>

Stroustrup provides some discussion of these issues in the final
chapters of TC++PL(SE). Have his recommendations been adopted by a
large number of programmers? I have not yet read the chapters. Are
they thorough enough to provide a solid foundation for organizing a
large-scale project?


I thought of these chapters when I saw the subject text. I highly suggest
you read the chapters; they're very good IMO.

- Pete

<snip>
Jul 22 '05 #2
Steven T. Hatton wrote:
<snip>

Stroustrup provides some discussion of these issues in the final
chapters of TC++PL(SE). Have his recommendations been adopted by a
large number of programmers? I have not yet read the chapters. Are
they thorough enough to provide a solid foundation for organizing a
large-scale project?


I thought of these chapters when I saw the subject text. I highly suggest
you read the chapters; they're very good IMO.

- Pete

<snip>
Jul 22 '05 #3
Steven T. Hatton wrote:
Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.


These are mostly Software Engineering issues.
You might try

"Large-Scale C++ Software Design" by John Lakos.

http://www.amazon.com/exec/obidos/tg...29721?v=glance

But be careful. It was published in July 1996
and contains some out-of-date recommendations.

Jul 22 '05 #4
Steven T. Hatton wrote:
Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.


These are mostly Software Engineering issues.
You might try

"Large-Scale C++ Software Design" by John Lakos.

http://www.amazon.com/exec/obidos/tg...29721?v=glance

But be careful. It was published in July 1996
and contains some out-of-date recommendations.

Jul 22 '05 #5
"Steven T. Hatton" wrote:

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.


Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it, but
it just popped into my head...
Jul 22 '05 #6
"Steven T. Hatton" wrote:

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.


Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it, but
it just popped into my head...
Jul 22 '05 #7
"E. Robert Tisdale" <E.**************@jpl.nasa.gov> wrote...
Steven T. Hatton wrote:
Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.
These are mostly Software Engineering issues.


So, why not recommend news:comp.software-eng ? :-)
[...]

Jul 22 '05 #8
"E. Robert Tisdale" <E.**************@jpl.nasa.gov> wrote...
Steven T. Hatton wrote:
Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.
These are mostly Software Engineering issues.


So, why not recommend news:comp.software-eng ? :-)
[...]

Jul 22 '05 #9
"Julie" <ju***@nospam.com> wrote
"Steven T. Hatton" wrote:

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.
Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it,

but it just popped into my head...


That's a good source for very abstract information, but it has very little
that would help with C++ specific issues. The articles are also of varying
quality. The best I've found were the ones on quality metrics and the ones
on fault tolerance.

Claudio Puviani
Jul 22 '05 #10
"Julie" <ju***@nospam.com> wrote
"Steven T. Hatton" wrote:

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.
Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it,

but it just popped into my head...


That's a good source for very abstract information, but it has very little
that would help with C++ specific issues. The articles are also of varying
quality. The best I've found were the ones on quality metrics and the ones
on fault tolerance.

Claudio Puviani
Jul 22 '05 #11
Claudio Puviani wrote:
"Julie" <ju***@nospam.com> wrote
"Steven T. Hatton" wrote:
>
> Is there a more or less accepted authority describing how to structure
> a
> project? I know Julie has asked about namespaces. That is certainly a
> part of my question, but I want to know about the whole picture.


Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it,

but
it just popped into my head...


That's a good source for very abstract information, but it has very little
that would help with C++ specific issues. The articles are also of varying
quality. The best I've found were the ones on quality metrics and the ones
on fault tolerance.

Claudio Puviani


I believe I found my answer WTFM!
http://docs.kde.org/en/HEAD/kdevelop.../newfiles.html
--
p->m == (*p).m == p[0].m
http://www.kdevelop.org
http://www.suse.com
http://www.mozilla.org
Jul 22 '05 #12
Claudio Puviani wrote:
"Julie" <ju***@nospam.com> wrote
"Steven T. Hatton" wrote:
>
> Is there a more or less accepted authority describing how to structure
> a
> project? I know Julie has asked about namespaces. That is certainly a
> part of my question, but I want to know about the whole picture.


Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it,

but
it just popped into my head...


That's a good source for very abstract information, but it has very little
that would help with C++ specific issues. The articles are also of varying
quality. The best I've found were the ones on quality metrics and the ones
on fault tolerance.

Claudio Puviani


I believe I found my answer WTFM!
http://docs.kde.org/en/HEAD/kdevelop.../newfiles.html
--
p->m == (*p).m == p[0].m
http://www.kdevelop.org
http://www.suse.com
http://www.mozilla.org
Jul 22 '05 #13
Julie wrote:
"Steven T. Hatton" wrote:

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.


Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it,
but it just popped into my head...


This is a living example of one of the most successful C++ dominated
software projects ever: http://www.mozilla.org/projects/

I recall looking at the NASA site a while back as well. The kind of stuff
I'm looking for is not the high-level abstraction, how to design your
interfaces between packages, etc., kind of literature. I want more
fundamental guidance on how to use the plethora of alternatives provided by
the features described in the Standard. I just read through Clause 3
(Chapter 3) of PL-C++03. This is out of date, but it will give a hint of
what the current document reads like. The stuff on name lookup is
mind-boggling. http://www.itga.com.au/~gnb/wp/cd2/

I do have a way of establishing a pretty powerful project structure in a
hurry. The KDE and KDevelop are doing a wonderful job. Unfortunately, some
of the outstanding performance is due to the contributions of uniquely
tallanted people, and not a codified approach. But it is open to
examination: http://ng-project.org/~kdevelop/apid.../inherits.html

The following is from a 'hello world' created by KDevelop:

hattons@ljosalfr:~/code/c++/managed/
Wed Apr 07 04:30:01:> find . -name "*"
..
../po
../po/Makefile.am
../po/Makefile.in
../doc
../doc/en
../doc/en/Makefile.am
../doc/en/Makefile.in
../doc/en/index.docbook
../doc/Makefile.am
../doc/Makefile.in
../src
../src/hi16-app-managed.png
../src/managed.cpp
../src/managed.lsm
../src/main.cpp
../src/managed.h
../src/Makefile.am
../src/Makefile.in
../src/managedui.rc
../src/hi32-app-managed.png
../src/managed.desktop
../NEWS
../TODO
../admin
../admin/CVS
../admin/CVS/Root
../admin/CVS/Repository
../admin/CVS/Entries
../admin/CVS/Template
../admin/compile
../admin/Doxyfile.global
../admin/depcomp
../admin/Makefile.common
../admin/ltmain.sh
../admin/config.pl
../admin/configure.in.min
../admin/config.guess
../admin/acinclude.m4.in
../admin/install-sh
../admin/config.sub
../admin/missing
../admin/mkinstalldirs
../admin/cvs.sh
../admin/bcheck.pl
../admin/nmcheck
../admin/conf.change.pl
../admin/am_edit
../admin/libtool.m4.in
../admin/ylwrap
../admin/cvs-clean.pl
../admin/debianrules
../admin/detect-autoconf.sh
../admin/ChangeLog
../admin/Doxyfile.am
../admin/configure.in.bot.end
../debug
../debug/po
../debug/po/Makefile
../debug/doc
../debug/doc/en
../debug/doc/en/Makefile
../debug/doc/en/index.cache.bz2
../debug/doc/Makefile
../debug/src
../debug/src/Makefile
../debug/src/.deps
../debug/src/.deps/managed.Po
../debug/src/.deps/main.Po
../debug/src/.libs
../debug/src/managed.moc
../debug/src/managed
../debug/src/managed.o
../debug/src/main.o
../debug/Makefile
../debug/config.status
../debug/libtool
../debug/config.log
../debug/config.h
../debug/stamp-h1
../aclocal.m4
../README
../configure
../autom4te.cache
../autom4te.cache/requests
../autom4te.cache/output.0
../autom4te.cache/traces.0
../configure.in
../subdirs
../Makefile.am
../Makefile.in
../configure.files
../configure.in.in
../config.h.in
../Makefile.cvs
../acinclude.m4
../managed.kdevelop
../stamp-h.in
../AUTHORS
../INSTALL
../ChangeLog
../COPYING
../Doxyfile
../templates
../templates/h
../templates/cpp
hattons@ljosalfr:~/code/c++/managed/
But, now I want to pull in stuff from boost, and Xerces. I know some of
it's just a question of time and experience, but there also seems to be
something fundamentally missing that would pull everything together. I'm
trying very hard not to draw comparrisons, but I've see some aspects of
programming managed more effectively than a lot of C++ stuff.
--
p->m == (*p).m == p[0].m
http://www.kdevelop.org
http://www.suse.com
http://www.mozilla.org
Jul 22 '05 #14
Julie wrote:
"Steven T. Hatton" wrote:

Is there a more or less accepted authority describing how to structure a
project? I know Julie has asked about namespaces. That is certainly a
part of my question, but I want to know about the whole picture.


Have you looked at the NASA SEL?

I looked at that a *long* time ago, and don't remember anything about it,
but it just popped into my head...


This is a living example of one of the most successful C++ dominated
software projects ever: http://www.mozilla.org/projects/

I recall looking at the NASA site a while back as well. The kind of stuff
I'm looking for is not the high-level abstraction, how to design your
interfaces between packages, etc., kind of literature. I want more
fundamental guidance on how to use the plethora of alternatives provided by
the features described in the Standard. I just read through Clause 3
(Chapter 3) of PL-C++03. This is out of date, but it will give a hint of
what the current document reads like. The stuff on name lookup is
mind-boggling. http://www.itga.com.au/~gnb/wp/cd2/

I do have a way of establishing a pretty powerful project structure in a
hurry. The KDE and KDevelop are doing a wonderful job. Unfortunately, some
of the outstanding performance is due to the contributions of uniquely
tallanted people, and not a codified approach. But it is open to
examination: http://ng-project.org/~kdevelop/apid.../inherits.html

The following is from a 'hello world' created by KDevelop:

hattons@ljosalfr:~/code/c++/managed/
Wed Apr 07 04:30:01:> find . -name "*"
..
../po
../po/Makefile.am
../po/Makefile.in
../doc
../doc/en
../doc/en/Makefile.am
../doc/en/Makefile.in
../doc/en/index.docbook
../doc/Makefile.am
../doc/Makefile.in
../src
../src/hi16-app-managed.png
../src/managed.cpp
../src/managed.lsm
../src/main.cpp
../src/managed.h
../src/Makefile.am
../src/Makefile.in
../src/managedui.rc
../src/hi32-app-managed.png
../src/managed.desktop
../NEWS
../TODO
../admin
../admin/CVS
../admin/CVS/Root
../admin/CVS/Repository
../admin/CVS/Entries
../admin/CVS/Template
../admin/compile
../admin/Doxyfile.global
../admin/depcomp
../admin/Makefile.common
../admin/ltmain.sh
../admin/config.pl
../admin/configure.in.min
../admin/config.guess
../admin/acinclude.m4.in
../admin/install-sh
../admin/config.sub
../admin/missing
../admin/mkinstalldirs
../admin/cvs.sh
../admin/bcheck.pl
../admin/nmcheck
../admin/conf.change.pl
../admin/am_edit
../admin/libtool.m4.in
../admin/ylwrap
../admin/cvs-clean.pl
../admin/debianrules
../admin/detect-autoconf.sh
../admin/ChangeLog
../admin/Doxyfile.am
../admin/configure.in.bot.end
../debug
../debug/po
../debug/po/Makefile
../debug/doc
../debug/doc/en
../debug/doc/en/Makefile
../debug/doc/en/index.cache.bz2
../debug/doc/Makefile
../debug/src
../debug/src/Makefile
../debug/src/.deps
../debug/src/.deps/managed.Po
../debug/src/.deps/main.Po
../debug/src/.libs
../debug/src/managed.moc
../debug/src/managed
../debug/src/managed.o
../debug/src/main.o
../debug/Makefile
../debug/config.status
../debug/libtool
../debug/config.log
../debug/config.h
../debug/stamp-h1
../aclocal.m4
../README
../configure
../autom4te.cache
../autom4te.cache/requests
../autom4te.cache/output.0
../autom4te.cache/traces.0
../configure.in
../subdirs
../Makefile.am
../Makefile.in
../configure.files
../configure.in.in
../config.h.in
../Makefile.cvs
../acinclude.m4
../managed.kdevelop
../stamp-h.in
../AUTHORS
../INSTALL
../ChangeLog
../COPYING
../Doxyfile
../templates
../templates/h
../templates/cpp
hattons@ljosalfr:~/code/c++/managed/
But, now I want to pull in stuff from boost, and Xerces. I know some of
it's just a question of time and experience, but there also seems to be
something fundamentally missing that would pull everything together. I'm
trying very hard not to draw comparrisons, but I've see some aspects of
programming managed more effectively than a lot of C++ stuff.
--
p->m == (*p).m == p[0].m
http://www.kdevelop.org
http://www.suse.com
http://www.mozilla.org
Jul 22 '05 #15

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

3
by: Ira Baxter | last post by:
Hi. We are working on tools to process PL/SQL code. What we need are precise details on the full PL/SQL syntax. We have the Oracle 9/10 documentation, but it seems a little fuzzy on the...
14
by: Steven T. Hatton | last post by:
Is there a more or less accepted authority describing how to structure a project? I know Julie has asked about namespaces. That is certainly a part of my question, but I want to know about the...
1
by: Divyesh | last post by:
Hello, I need some help to get out of cumbersome process. For example, I've one solution with 2 EXE & a DLL project. DLL is referred by both exe projects hence I've added DLL as reference to...
1
by: Sonnysonu | last post by:
This is the data of csv file 1 2 3 1 2 3 1 2 3 1 2 3 2 3 2 3 3 the lengths should be different i have to store the data by column-wise with in the specific length. suppose the i have to...
0
by: Hystou | last post by:
There are some requirements for setting up RAID: 1. The motherboard and BIOS support RAID configuration. 2. The motherboard has 2 or more available SATA protocol SSD/HDD slots (including MSATA, M.2...
0
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However,...
0
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can...
0
Oralloy
by: Oralloy | last post by:
Hello folks, I am unable to find appropriate documentation on the type promotion of bit-fields when using the generalised comparison operator "<=>". The problem is that using the GNU compilers,...
0
jinu1996
by: jinu1996 | last post by:
In today's digital age, having a compelling online presence is paramount for businesses aiming to thrive in a competitive landscape. At the heart of this digital strategy lies an intricately woven...
0
tracyyun
by: tracyyun | last post by:
Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each...
0
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome a new...
0
by: adsilva | last post by:
A Windows Forms form does not have the event Unload, like VB6. What one acts like?

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.