202522 - documentation for site Makefile and related files

Status: RESOLVED INVALID

(Developer Documentation Graveyard :: General, defect)

Description

[Brant Gurganus]

User-Agent:       Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.4b) Gecko/20030412
Build Identifier: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.4b) Gecko/20030412

In my efforts to better understand how the Makefile and related files build the
Website, I am trying to document things as I go.

Reproducible: Always

Steps to Reproduce:
1. Look at the Makefile.
Actual Results:  
There is very little documentation as to what is happening.

Expected Results:  
There should be documentation of what is happening.

Comment 1

[Brant Gurganus]

Attachment: documented Makefile

This is a documented Makefile.	I also made a few changes such as making the
build types prerequisites of .PROTO so that they build unconditionally and I
made all a prerequisite of .DEFAULT.  I also made a few changes according to
the Makefile conventions section of the online GNU make manual.

This patch is the whole file as opposed to a diff since so many lines are
changes.

Comment 2

[Brant Gurganus]

cc'ing myk and leaf as requested

Comment 3

[Brant Gurganus]

Also, can the line 

  $(RM) $(RMFLAGS) -r ./output ./search/output

be deleted since the server doesn't need to do anything to search since we are
using Google now.

Comment 4

[Myk Melez [:myk] [@mykmelez]]

well, it's possible that ./search/output can be removed from the file, but
./output needs to stay in there I wager.

Comment 5

[Brant Gurganus]

Also fixed a mistake I added in the fascist build target.

Comment 6

[Daniel Wang]

*** Bug 229966 has been marked as a duplicate of this bug. ***

Comment 7

[Daniel Wang]

-> Brant

Comment 8

[Eric Shepherd [:sheppy]]

Given that the web site is undergoing a massive redesign, is this something that's still relevant?

Comment 9

[David Boswell]

The new design is up and www.mozilla.org is no longer using the build system.  Not sure if any other sites use it though.

Comment 10

[John Karahalis [:openjck]]

Automatically closing all bugs that have not been updated in a while. Please reopen if this is still important to you and has not yet been corrected.

Comment 11

[John Karahalis [:openjck]]

Reopening for review by Sheppy.

Comment 12

[Eric Shepherd [:sheppy]]

This is entirely obsolete.