[Bug 105] New: improve documentation about gdc internals

[gdc-bugzilla at gdcproject.org]

http://bugzilla.gdcproject.org/show_bug.cgi?id=105

             Bug #: 105
           Summary: improve documentation about gdc internals
    Classification: Unclassified
           Product: GDC
           Version: development
          Platform: All
        OS/Version: Other
            Status: NEW
          Severity: major
          Priority: Normal
         Component: gdc
        AssignedTo: ibuclaw at gdcproject.org
        ReportedBy: slavo5150 at yahoo.com


Created attachment 62
  --> http://bugzilla.gdcproject.org/attachment.cgi?id=62
MinGW.wiki

This was migrated from
https://bitbucket.org/goshawk/gdc/issue/41/improve-documentation-about-gdc-internals


trass3r created an issue 2010-07-17
********************************************
Information about gdc internals is very spare here, i.e. what exactly has been
changed to transform a syntax tree from dmd's frontend into gcc intermediate
representation, what files are affected (e.g. when updating to a new frontend
version: which files need to be taken good care of), ...

Adding these information would ease getting started for new developers.


trass3r - 2010-07-21
********************************************
* attached MinGW.wiki

Not strictly about gdc internals, but I've attached some wiki source based on
ibuclaw's explanations about compiling gdc with MinGW. It might serve as a
start.


Iain Buclaw - 2010-07-21
********************************************
I barely understand it myself, so naturally I'll approve. :)

Considering that the average project has 10 lines of comments for every 100
LOC, I don't think we are doing that bad. Once druntime is up and running for
D2, I think that will be a good time to stop and test heavily for regressions
and bugs - most notably platform-specific quirks. Then focus on building our
portfolio for documentation and in code comments.

Technical prose is almost immortal.
                                  — Frederick P. Brooks, Jr.



trass3r - 2010-07-21
********************************************
As I already said on IRC, gcc 4.3.5 compiles just as good / bad as 4.1.2 using

../configure --enable-languages=d --disable-bootstrap --disable-nls
--enable-checking --disable-multilib --disable-shared --prefix=/mingw && make
-j 2

That '%' makefile error didn't occur.



Michael Parrott - 2010-07-22
********************************************
* changed status to open

A documentation page is now in the works. Scroll down to the bottom to find the
link to the Documentation page. Or just follow this link:

http://bitbucket.org/goshawk/gdc/wiki/Documentation

Note that right now, there is next to no content on it.

Also, I added the MinGW page to the wiki as well.

http://bitbucket.org/goshawk/gdc/wiki/MinGW

It can be found on the Home wiki page in the Installation section.



Michael Parrott - 2010-08-03
********************************************
There are now separate pages for User and Developer documentation:

http://bitbucket.org/goshawk/gdc/wiki/DeveloperDocumentation

http://bitbucket.org/goshawk/gdc/wiki/UserDocumentation

The command line options and descriptions on the User documentation page were
taken from lang.opt.

-- 
Configure bugmail: http://bugzilla.gdcproject.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching all bug changes.