149248 - Modularity issues document

Status: RESOLVED INVALID

(Developer Documentation Graveyard :: General, enhancement)

Description

[Brian 'netdragon' Bober]

I didn't file this in Documents because I think this would be best written by
the people in charge of the build system.

There needs to be a document on the modularization of Mozilla. I realized this
when trying to build nsprpub only to use as part of another project. Not only
did it not like when I used another directory name other than Mozilla, I also
had to pull all the tree (which I didn't want), and gave up trying to do it.

This document should talk about:
- Build system layout
- Tools it uses (automake, etc)
- Dependencies
- How to isolate/extract parts of the tree for work on a specific issue
- What is going on to make Mozilla more modular
- How to make c++/javascript apps based on all or part of the Mozilla tree
- Explain the sections of the make files (i.e. client.mk) so people will know
how to remove parts of them and change them
- Explain how to rename directories, and insert modules

Comment 1

[hacker formerly known as [e-mail]]

Have at it.  A portion of what you describe is known as "embedding" and can be
found under http://www.mozilla.org/projects/embedding/ .

Comment 2

[Daniel Wang]

-> d11n

Comment 3

[Nickolay_Ponomarev]

(In reply to comment #0)
> This document should talk about:
> - Build system layout
> - Tools it uses (automake, etc)
> - Dependencies
There's http://developer.mozilla.org/en/docs/Build_Documentation which is the place for build system docs. If there are specific things that need to be added / changed, file separate bugs; to the best of my knowledge the basics are explained already.

> - How to isolate/extract parts of the tree for work on a specific issue
http://developer.mozilla.org/en/docs/Build_Documentation + http://developer.mozilla.org/en/docs/Incremental_Build or see the docs for the specific project you work on. This documentation is likely project-specific for things like nspr and nss.

> - What is going on to make Mozilla more modular
> - How to make c++/javascript apps based on all or part of the Mozilla tree
This isn't specific enough request.

> - Explain the sections of the make files (i.e. client.mk) so people will know
> how to remove parts of them and change them
bsmedberg has been working on it - http://developer.mozilla.org/en/docs/Category:Build_Glossary

This bug is quite old and I don't believe it's useful, so closing.