X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Fdevinfo.html;h=df0e7265249a698dfee86e6a3cd09a43e2547759;hb=29495bbb84a4f4517b108f2e88e0edc60bb4a341;hp=9fcd8cf5358237937e8f3215cb59961809e570bc;hpb=36da0459e4d0b12ab46f0e2090d107a22f68844a;p=mesa.git diff --git a/docs/devinfo.html b/docs/devinfo.html index 9fcd8cf5358..df0e7265249 100644 --- a/docs/devinfo.html +++ b/docs/devinfo.html @@ -34,11 +34,15 @@ To add a new GL extension to Mesa you have to do at least the following. corresponding Python scripts.
  • - Find an existing extension that's similar to the new one and search - the sources for code related to that extension. - Implement new code as needed. - In general, new state variables will be added to mtypes.h. If the - extension is rather large, try to implement it in a new source file. + Add a new entry to the gl_extensions struct in mtypes.h +
  • +
  • + Update the extensions.c file. +
  • +
  • + From this point, the best way to proceed is to find another extension, + similar to the new one, that's already implemented in Mesa and use it + as an example.
  • If the new extension adds new GL state, the functions in get.c, enable.c @@ -83,7 +87,7 @@ Brace example: Here's the GNU indent command which will best approximate my preferred style:

    -	indent -br -i3 -npcs infile.c -o outfile.c
    +	indent -br -i3 -npcs --no-tabs infile.c -o outfile.c
     
    @@ -103,7 +107,7 @@ Global variables are not allowed. Function name examples:

    -	glFooBar()       - a public GL entry point (in dispatch.c)
    +	glFooBar()       - a public GL entry point (in glapi_dispatch.c)
     	_mesa_FooBar()   - the internal immediate mode function
     	save_FooBar()    - retained mode (display list) function in dlist.c
     	foo_bar()        - a static (private) function
    @@ -119,48 +123,46 @@ These are the instructions for making a new Mesa release.
     
     

    Get latest source files

    -Use "cvs update -dAP " to get the latest Mesa files from CVS. +Use git to get the latest Mesa files from the git repository, from whatever +branch is relevant.

    Verify and update version info

    -Create/edit the docs/RELNOTES-X.Y file to document what's new in the release. -Add the new RELNOTES-X.Y file to relnotes.html. -Update the docs/VERSIONS file too. -

    - -

    -Edit configs/default and change the MESA_MAJOR, MESA_MINOR and MESA_TINY -version numbers. +Create/edit the docs/relnotes-x.y.html file to document what's new in the release. +Add the new relnotes-x.y.html file to relnotes.html.

    -Make sure the values in src/mesa/main/version.h is correct. +Update the MESA_MAJOR, MESA_MINOR and MESA_TINY version numbers in +configs/default. +Also update the VERSION line in the top-level Makefile.

    -Edit the top-level Makefile and verify that DIRECTORY, LIB_NAME and -DEMO_NAME are correct. +Make sure the values in src/mesa/main/version.h are correct.

    -Update the docs/news.html file and docs/contents.html files. +Update the docs/news.html file and docs/download.html files.

    -Check in all updates to CVS. +Check in all updates to git.

    -Tag the CVS files with the release name (in the form mesa_X_Y). +Tag the files with the release name (in the form mesa_X_Y) +with: git tag -a mesa_X_Y +Then: git push origin mesa_X_Y

    Make the tarballs

    Make a symbolic link from $(DIRECTORY) to 'Mesa'. For example, -ln -s Mesa Mesa-6.3 +ln -s Mesa Mesa-7.5 This is needed in order to make a correct tar file in the next step.

    @@ -173,7 +175,7 @@ Make the distribution files. From inside the Mesa directory:

    After the tarballs are created, the md5 checksums for the files will be computed. -Add them to the docs/news.html file. +Add them to the docs/relnotes-X.Y.html file.

    @@ -187,9 +189,21 @@ Follow the directions on SourceForge for creating a new "release" and uploading the tarballs.

    +

    +Basically, to upload the tarball files with: +
    + +rsync -avP ssh Mesa*-X.Y.* USERNAME@frs.sourceforge.net:uploads/ + +

    +

    Update the web site by copying the docs/ directory's files to -/home/users/b/br/brianp/mesa-www/htdocs/ +/home/users/b/br/brianp/mesa-www/htdocs/ with: +
    + +sftp USERNAME,mesa3d@web.sourceforge.net +