X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Freleasing.html;h=66742b0bcb4bd4bc52614d9c442a64e1c8017238;hb=d547e18184978affd95a72dc524ca648efbe9812;hp=e2206b539a97d9f2d0bd2bcd2deef783ef1edc04;hpb=a68d306a1d8f583262e705d347ac860de0a0cd30;p=mesa.git diff --git a/docs/releasing.html b/docs/releasing.html index e2206b539a9..66742b0bcb4 100644 --- a/docs/releasing.html +++ b/docs/releasing.html @@ -24,7 +24,6 @@
  • Making a branchpoint
  • Pre-release announcement
  • Making a new release -
  • Update the calendar
  • Announce the release
  • Update the mesa3d.org website
  • Update Bugzilla @@ -429,6 +428,7 @@ Here is one solution that I've been using.

    +	# Set MAKEFLAGS if you haven't already
     	git clean -fXd; git clean -nxd
     	read # quick cross check any outstanding files
     	export __version=`cat VERSION`
    @@ -437,7 +437,12 @@ Here is one solution that I've been using.
     	chmod 755 -fR $__build_root; rm -rf $__build_root
     	mkdir -p $__build_root && cd $__build_root
     
    -	$__mesa_root/autogen.sh && make -j2 distcheck
    +	# For the native builds - such as distcheck, scons, sanity test, you
    +	# may want to specify which LLVM to use:
    +	# export LLVM_CONFIG=/usr/lib/llvm-3.9/bin/llvm-config
    +
    +	# Do a full distcheck
    +	$__mesa_root/autogen.sh && make distcheck
     
     	# Build check the tarballs (scons, linux)
     	tar -xaf mesa-$__version.tar.xz && cd mesa-$__version
    @@ -445,12 +450,16 @@ Here is one solution that I've been using.
     	cd .. && rm -rf mesa-$__version
     
     	# Build check the tarballs (scons, windows/mingw)
    +	# Temporary drop LLVM_CONFIG, unless you have a Windows/mingw one.
    +	# save_LLVM_CONFIG=`echo $LLVM_CONFIG`; unset LLVM_CONFIG
     	tar -xaf mesa-$__version.tar.xz && cd mesa-$__version
     	scons platform=windows toolchain=crossmingw
     	cd .. && rm -rf mesa-$__version
     
     	# Test the automake binaries
     	tar -xaf mesa-$__version.tar.xz && cd mesa-$__version
    +	# Restore LLVM_CONFIG, if applicable:
    +	# export LLVM_CONFIG=`echo $save_LLVM_CONFIG`; unset save_LLVM_CONFIG
     	./configure \
     		--with-dri-drivers=i965,swrast \
     		--with-gallium-drivers=swrast \
    @@ -460,25 +469,26 @@ Here is one solution that I've been using.
     		--enable-glx-tls \
     		--enable-gbm \
     		--enable-egl \
    -		--with-egl-platforms=x11,drm,wayland
    -	make -j2 && DESTDIR=`pwd`/test make -j6 install
    +		--with-platforms=x11,drm,wayland,surfaceless
    +	make && DESTDIR=`pwd`/test make install
     	__glxinfo_cmd='glxinfo 2>&1 | egrep -o "Mesa.*|Gallium.*|.*dri\.so"'
     	__glxgears_cmd='glxgears 2>&1 | grep -v "configuration file"'
     	__es2info_cmd='es2_info 2>&1 | egrep "GL_VERSION|GL_RENDERER|.*dri\.so"'
     	__es2gears_cmd='es2gears_x11 2>&1 | grep -v "configuration file"'
    -	export LD_LIBRARY_PATH=`pwd`/test/usr/local/lib/
    +	test "x$LD_LIBRARY_PATH" != 'x' && __old_ld="$LD_LIBRARY_PATH"
    +	export LD_LIBRARY_PATH=`pwd`/test/usr/local/lib/:"${__old_ld}"
     	export LIBGL_DRIVERS_PATH=`pwd`/test/usr/local/lib/dri/
     	export LIBGL_DEBUG=verbose
     	eval $__glxinfo_cmd
     	eval $__glxgears_cmd
     	eval $__es2info_cmd
     	eval $__es2gears_cmd
    -	export LIBGL_ALWAYS_SOFTWARE=1
    +	export LIBGL_ALWAYS_SOFTWARE=true
     	eval $__glxinfo_cmd
     	eval $__glxgears_cmd
     	eval $__es2info_cmd
     	eval $__es2gears_cmd
    -	export LIBGL_ALWAYS_SOFTWARE=1
    +	export LIBGL_ALWAYS_SOFTWARE=true
     	export GALLIUM_DRIVER=softpipe
     	eval $__glxinfo_cmd
     	eval $__glxgears_cmd
    @@ -486,6 +496,7 @@ Here is one solution that I've been using.
     	eval $__es2gears_cmd
     	# Smoke test DOTA2
     	unset LD_LIBRARY_PATH
    +	test "x$__old_ld" != 'x' && export LD_LIBRARY_PATH="$__old_ld" && unset __old_ld
     	unset LIBGL_DRIVERS_PATH
     	unset LIBGL_DEBUG
     	unset LIBGL_ALWAYS_SOFTWARE
    @@ -540,6 +551,8 @@ Start the release process.
     

    +	# For the dist/distcheck, you may want to specify which LLVM to use:
    +	# export LLVM_CONFIG=/usr/lib/llvm-3.9/bin/llvm-config
     	../relative/path/to/release.sh . # append --dist if you've already done distcheck above
     
    @@ -566,23 +579,17 @@ Something like the following steps will do the trick:

    -Also, edit docs/relnotes.html to add a link to the new release notes, and edit -docs/index.html to add a news entry. Then commit and push: +Also, edit docs/relnotes.html to add a link to the new release notes, +edit docs/index.html to add a news entry, and remove the version from +docs/release-calendar.html. Then commit and push:

    -	git commit -as -m "docs: add news item and link release notes for X.Y.Z"
    +	git commit -as -m "docs: update calendar, add news item and link release notes for X.Y.Z"
     	git push origin master X.Y
     
    -

    Update the calendar

    - -

    -Remove the version from the calendar. -

    - -

    Announce the release