From 8620f53212df1a96f5ae1d180dacb28418bf6cc8 Mon Sep 17 00:00:00 2001 From: Erik Faye-Lund Date: Mon, 3 Jun 2019 18:30:23 +0200 Subject: docs: do not use br-tag for non-significant breaks According to the W3C, we shouldn't use the br-tag unless the line-break is part of the content: https://www.w3.org/TR/2011/WD-html5-author-20110809/the-br-element.html All of these instances are for non-content usage, and is as such technically out-of-spec. So let's either remove them, or split paragraphs, based on how related the content are. Signed-off-by: Erik Faye-Lund Reviewed-by: Emil Velikov Reviewed-by: Eric Engestrom --- docs/envvars.html | 7 ++---- docs/index.html | 61 +++++++++++++++++++++++++++++---------------- docs/precompiled.html | 3 +-- docs/release-calendar.html | 31 +++++++++++++++-------- docs/releasing.html | 41 ++++++++++++++++-------------- docs/relnotes/6.4.2.html | 3 +-- docs/relnotes/6.5.2.html | 4 +-- docs/relnotes/6.5.html | 21 +++++++++------- docs/relnotes/9.0.html | 1 - docs/repository.html | 6 ++--- docs/submittingpatches.html | 15 +++++++---- docs/thanks.html | 13 +++------- docs/vmware-guest.html | 13 ++++++---- 13 files changed, 125 insertions(+), 94 deletions(-) (limited to 'docs') diff --git a/docs/envvars.html b/docs/envvars.html index e4d929ebd14..3afdcee8543 100644 --- a/docs/envvars.html +++ b/docs/envvars.html @@ -52,11 +52,8 @@ sometimes be useful for debugging end-user issues.
  • MESA_DEBUG - if set, error messages are printed to stderr. For example, if the application generates a GL_INVALID_ENUM error, a corresponding error message indicating where the error occurred, and possibly why, will be - printed to stderr.
    - - For release builds, MESA_DEBUG defaults to off (no debug output). - - MESA_DEBUG accepts the following comma-separated list of named + printed to stderr. For release builds, MESA_DEBUG defaults to off (no debug + output). MESA_DEBUG accepts the following comma-separated list of named flags, which adds extra behaviour to just set MESA_DEBUG=1:
    • silent - turn off debug messages. Only useful for debug builds.
      • diff --git a/docs/index.html b/docs/index.html index d472a311f8d..63667674a99 100644 --- a/docs/index.html +++ b/docs/index.html @@ -43,7 +43,8 @@ This is a bug-fix release.

      Mesa 18.3.6 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 18.3.6 will be the final release in the 18.3 series. Users of 18.3 are encouraged to migrate to the 19.0 series in order to obtain future fixes. @@ -90,7 +91,8 @@ This is a bug-fix release.

      Mesa 18.2.8 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 18.2.8 will be the final release in the 18.2 series. Users of 18.2 are encouraged to migrate to the 18.3 series in order to obtain future fixes. @@ -149,7 +151,8 @@ This is a bug-fix release.

      Mesa 18.1.9 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 18.1.9 will be the final release in the 18.1 series. Users of 18.1 are encouraged to migrate to the 18.2 series in order to obtain future fixes. @@ -211,7 +214,8 @@ This is a bug-fix release.

      Mesa 18.0.5 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 18.0.5 will be the final release in the 18.0 series. Users of 18.0 are encouraged to migrate to the 18.1 series in order to obtain future fixes. @@ -258,7 +262,8 @@ This is a bug-fix release.

      Mesa 17.3.9 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 17.3.9 will be the final release in the 17.3 series. Users of 17.3 are encouraged to migrate to the 18.0 series in order to obtain future fixes. @@ -317,7 +322,8 @@ This is a bug-fix release.

      Mesa 17.2.8 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 17.2.8 will be the final release in the 17.2 series. Users of 17.2 are encouraged to migrate to the 17.3 series in order to obtain future fixes. @@ -376,7 +382,8 @@ This is a bug-fix release.

      Mesa 17.1.10 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 17.1.10 will be the final release in the 17.1 series. Users of 17.1 are encouraged to migrate to the 17.2 series in order to obtain future fixes. @@ -447,7 +454,8 @@ This is a bug-fix release.

      Mesa 17.0.7 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 17.0.7 will be the final release in the 17.0 series. Users of 17.0 are encouraged to migrate to the 17.1 series in order to obtain future fixes. @@ -496,7 +504,8 @@ This is a bug-fix release. Mesa 17.0.2 are released. These are bug-fix releases from the 13.0 and 17.0 branches, respectively. -
      +

      +

      NOTE: It is anticipated that 13.0.6 will be the final release in the 13.0 series. Users of 13.0 are encouraged to migrate to the 17.0 series in order to obtain future fixes. @@ -531,7 +540,8 @@ This is a bug-fix release.

      Mesa 12.0.6 is released. This is a bug-fix release. -
      +

      +

      NOTE: This is an extra release for the 12.0 stable branch, as per developers' feedback. It is anticipated that 12.0.6 will be the final release in the 12.0 series. Users of 12.0 are encouraged to migrate to the 13.0 series in order @@ -548,7 +558,8 @@ This is a bug-fix release.

      Mesa 12.0.5 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 12.0.5 will be the final release in the 12.0 series. Users of 12.0 are encouraged to migrate to the 13.0 series in order to obtain future fixes. @@ -610,7 +621,8 @@ about the release. Mesa 11.2.2 are released. These are bug-fix releases from the 11.1 and 11.2 branches, respectively. -
      +

      +

      NOTE: It is anticipated that 11.1.4 will be the final release in the 11.1.4 series. Users of 11.1 are encouraged to migrate to the 11.2 series in order to obtain future fixes. @@ -641,7 +653,8 @@ This is a bug-fix release.

      Mesa 11.0.9 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 11.0.9 will be the final release in the 11.0 series. Users of 11.0 are encouraged to migrate to the 11.1 series in order to obtain future fixes. @@ -705,7 +718,8 @@ This is a bug-fix release.

      Mesa 10.6.9 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 10.6.9 will be the final release in the 10.6 series. Users of 10.6 are encouraged to migrate to the 11.0 series in order to obtain future fixes. @@ -776,7 +790,8 @@ This is a bug-fix release.

      Mesa 10.5.9 is released. This is a bug-fix release. -
      +

      +

      NOTE: It is anticipated that 10.5.9 will be the final release in the 10.5 series. Users of 10.5 are encouraged to migrate to the 10.6 series in order to obtain future fixes. @@ -886,7 +901,8 @@ This is a bug-fix release. and Mesa 10.4.2 are released. These are bug-fix releases from the 10.3 and 10.4 branches, respectively. -
      +

      +

      NOTE: It is anticipated that 10.3.7 will be the final release in the 10.3 series. Users of 10.3 are encouraged to migrate to the 10.4 series in order to obtain future fixes. @@ -937,7 +953,8 @@ This is a bug-fix release. and Mesa 10.3.1 are released. These are bug-fix releases from the 10.2 and 10.3 branches, respectively. -
      +

      +

      NOTE: It is anticipated that 10.2.9 will be the final release in the 10.2 series. Users of 10.2 are encouraged to migrate to the 10.3 series in order to obtain future fixes. @@ -1049,7 +1066,8 @@ This is a bug-fix release.

      Mesa 10.0.5 is released. This is a bug-fix release. -
      +

      +

      NOTE: Since the 10.1.1 release is being released concurrently, it is anticipated that 10.0.5 will be the final release in the 10.0 series. Users of 10.0 are encouraged to migrate to the 10.1 series in @@ -2358,7 +2376,7 @@ Here's what's new:

      April 29, 2001

      New Mesa website

      -

      Mark Manning produced the new website.
      Thanks, Mark!

      +

      Mark Manning produced the new website. Thanks, Mark!

      February 14, 2001

      @@ -2477,8 +2495,9 @@ just bug fixes.

      Please report any problems with this release ASAP. Bugs should be filed on the -Mesa3D website at sourceforge.
      -After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.

      +Mesa3D website at sourceforge. +

      +

      After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.

      -- Brian

      December 17, 1999

      diff --git a/docs/precompiled.html b/docs/precompiled.html index 22fac6cb081..0dc02504a66 100644 --- a/docs/precompiled.html +++ b/docs/precompiled.html @@ -22,9 +22,8 @@ In general, precompiled Mesa libraries are not available.

      Some Linux distributions closely follow the latest Mesa releases. On others one has to use unofficial channels. -
      -There are some general directions:

      +

      There are some general directions:

      • Debian/Ubuntu based distros - PPA: xorg-edgers, oibaf and padoka
      • Fedora - Corp: erp and che
        • diff --git a/docs/release-calendar.html b/docs/release-calendar.html index e356af7fe48..70ed0112576 100644 --- a/docs/release-calendar.html +++ b/docs/release-calendar.html @@ -21,20 +21,29 @@

        Mesa provides feature/development and stable releases.

        +

        The table below lists the date and release manager that is expected to do the specific release. -
        -Regular updates will ensure that the schedule for the current and the -next two feature releases are shown in the table. -
        -In order to keep the whole releasing team up to date with the tools -used, best practices and other details, the member in charge of the -next feature release will be in constant rotation. -
        -The way the release schedule works is -explained here. -
        +

        + +

        +Regular updates will ensure that the schedule for the current and the next two +feature releases are shown in the table. +

        + +

        +In order to keep the whole releasing team up to date with the tools used, best +practices and other details, the member in charge of the next feature release +will be in constant rotation. +

        + +

        +The way the release schedule works is explained +here. +

        +

        Take a look here if you'd like to nominate a patch in the next stable release.

        diff --git a/docs/releasing.html b/docs/releasing.html index 12f24fe52d1..873cc25eb9b 100644 --- a/docs/releasing.html +++ b/docs/releasing.html @@ -36,7 +36,9 @@

        This document uses the convention X.Y.Z for the release number with X.Y being the stable branch name. -
        +

        + +

        Mesa provides feature and bugfix releases. Former use zero as patch version (Z), while the latter have a non-zero one.

        @@ -57,7 +59,9 @@ For example:

        Releases should happen on Wednesdays. Delays can occur although those should be kept to a minimum. -
        +

        + +

        See our calendar for information about how the release schedule is planned, and the date and other details for individual releases. @@ -85,10 +89,14 @@ approximately 48 hours before the actual release.

        Note: There is one or two releases overlap when changing branches. For example: -
        +

        + +

        The final release from the 12.0 series Mesa 12.0.5 will be out around the same time (or shortly after) 13.0.1 is out. -
        +

        + +

        This also involves that, as a final release may be delayed due to the need of additional candidates to solve some blocking regression(s), the release manager might have to update @@ -167,9 +175,8 @@ good contact point.

        Note: If a patch in the current queue needs any additional -fix(es), then they should be squashed together. -
        -The commit messages and the cherry picked from tags must be preserved. +fix(es), then they should be squashed together. The commit messages and the +cherry picked from tags must be preserved.

        @@ -252,9 +259,8 @@ stabilisation and bugfixing.

        Note: Before doing a branch ensure that basic build and meson test -testing is done and there are little to-no issues. -
        -Ideally all of those should be tackled already. +testing is done and there are little to-no issues. Ideally all of those should +be tackled already.

        @@ -300,7 +306,8 @@ It comes shortly after outstanding patches in the respective branch are pushed. Developers can check, in brief, what's the status of their patches. They, alongside very early testers, are strongly encouraged to test the branch and report any regressions. -
        +

        +

        It is followed by a brief period (normally 24 or 48 hours) before the actual release is made.

        @@ -330,10 +337,8 @@ Barring reported regressions or objections from developers.

        Patch does not fit the criteria and -is followed by a brief information. -
        -The release maintainer is human so if you believe you've spotted a mistake do -let them know. +is followed by a brief information. The release maintainer is human so if you +believe you've spotted a mistake do let them know.

        Format/template

        @@ -623,10 +628,8 @@ website. Manually check that it is updated 5-10 minutes after the final gi

        Parse through the bugreports as listed in the docs/relnotes/X.Y.Z.html -document. -
        -If there's outstanding action, close the bug referencing the commit ID which -addresses the bug and mention the Mesa version that has the fix. +document. If there's outstanding action, close the bug referencing the commit +ID which addresses the bug and mention the Mesa version that has the fix.

        diff --git a/docs/relnotes/6.4.2.html b/docs/relnotes/6.4.2.html index 3528f32caa1..1aa48979bce 100644 --- a/docs/relnotes/6.4.2.html +++ b/docs/relnotes/6.4.2.html @@ -43,8 +43,7 @@ fe1523744fc05edc3811dfc6a1bf4181 MesaGLUT-6.4.2.zip

        Changes

          -
        • GLUT tarball -
          +
        • GLUT tarball: Starting with 6.4, the GLUT library sources are distributed in a separate tarball. This was done at the request of Linux distro vendors who prefer to use freeglut. diff --git a/docs/relnotes/6.5.2.html b/docs/relnotes/6.5.2.html index 476e8edaa46..3af3ce73bba 100644 --- a/docs/relnotes/6.5.2.html +++ b/docs/relnotes/6.5.2.html @@ -41,10 +41,10 @@ c6d7134843ed5faf11f6686ecb5d2a2e MesaGLUT-6.5.2.zip
        • New DRI memory manager system. Currently used by the i915tex driver. Other DRI drivers will be updated to use the new memory manager in coming months. -
          +

          To use the new driver you'll need the most recent DRM library and drivers (version 2.2 or later) and a recent xf86-video-intel driver module from X.org. -
          +

          New features resulting from this work include:
          • EXT_framebuffer_objects, render to texture diff --git a/docs/relnotes/6.5.html b/docs/relnotes/6.5.html index 44896102648..25f4440c325 100644 --- a/docs/relnotes/6.5.html +++ b/docs/relnotes/6.5.html @@ -39,33 +39,36 @@ ac1d585483617db0c91e5c15cb5ec3a3 MesaGLUT-6.5.tar.gz

            New Features

            • OpenGL Shading language support -
              +

              This includes the GL_ARB_shader_objects, GL_ARB_shading_language_100, GL_ARB_vertex_shader and GL_ARB_fragment_shader extensions. Most of the work was done by Michal Krol. There's probably a fair number of bugs since this is a pretty large, complicated body of code. -
              +

              +

              The OpenGL 2.0 interface to these features will be implemented in a future version of Mesa, +

            • GL_EXT_timer_query -
              +

              Used to measure the time of OpenGL operations at high precision. Only supported in the software/Xlib driver at this time. - +

            • GL_EXT_packed_depth_stencil -
              +

              Defines a new GL_DEPTH_STENCIL_EXT pixel format. - +

            • GL_EXT_framebuffer_blit -
              +

              A simplified glCopyPixels-like feature for copying pixel rectangles. - +

            • GL_ARB_half_float_pixel -
              +

              Adds a new half-precision floating point format for image transfers, such as for glDrawPixels, glReadPixels, glTexImage, etc. +

            Changes

            diff --git a/docs/relnotes/9.0.html b/docs/relnotes/9.0.html index b629f889d80..8273ef89fbf 100644 --- a/docs/relnotes/9.0.html +++ b/docs/relnotes/9.0.html @@ -84,7 +84,6 @@ by Khronos.
            • The legacy/static Makefile system (ex: 'make linux-dri') has been removed. -
              The two supported build methods are now autoconf/automake and SCons.
            • Removed support for GL_ARB_shadow_ambient extension
              • diff --git a/docs/repository.html b/docs/repository.html index c8e2c62fc5e..012d3d9ba08 100644 --- a/docs/repository.html +++ b/docs/repository.html @@ -49,7 +49,7 @@ To get the Mesa sources anonymously (read-only):

                -
              1. Install the git software on your computer if needed.

                +
              2. Install the git software on your computer if needed.
              3. Get an initial, local copy of the repository with: 
                     git clone https://gitlab.freedesktop.org/mesa/mesa.git
@@ -129,7 +129,6 @@ and to LF on commit.
 
                
 Unix users don't need to set this option.
 
                
-
                
 
 
 
                Development Branches
                
@@ -212,7 +211,8 @@ If you are familiar with CVS or similar system, this is similar to doing a
 the current repository state, instead of the time you did the last update.
 (CVS doesn't work like git in this respect, but this is easiest way
 to explain it.)
-
                
+
                
+
                
 In any case, your repository now looks like you made your changes after
 all the other changes.
 
                
diff --git a/docs/submittingpatches.html b/docs/submittingpatches.html
index 48cc6768b46..81fa4cddea7 100644
--- a/docs/submittingpatches.html
+++ b/docs/submittingpatches.html
@@ -118,9 +118,9 @@ patch has already been reviewed.
 
              4. In order for your patch to reach the prospective reviewer easier/faster,
 use the script scripts/get_reviewer.pl to get a list of individuals and include
 them in the CC list.
-
                
+
                
 Please use common sense and do not blindly add everyone.
-
                
+
                
 
                     $ scripts/get_reviewer.pl --help # to get the help screen
     $ scripts/get_reviewer.pl -f src/egl/drivers/dri2/platform_android.c
@@ -207,7 +207,9 @@ state of your old patches to Superseded.
 
                
 Some companies' mail server automatically append a legal disclaimer,
 usually containing something along the lines of "The information in this
-email is confidential" and "distribution is strictly prohibited".
                
+email is confidential" and "distribution is strictly prohibited".
+
                
+
                
 These legal notices prevent us from being able to accept your patch,
 rendering the whole process pointless. Please make sure these are
 disabled before sending your patches. (Note that you may need to contact
@@ -382,7 +384,6 @@ won't have any negative effect on the patch nomination.
 
                
 Note: by removing the tag [as the commit is pushed] the patch is
 explicitly rejected from inclusion in the stable branch(es).
-
                
 Thus, drop the line only if you want to cancel the nomination.
 
                
 
@@ -448,14 +449,18 @@ be lost from the stable branch if developers push things directly. Consider
 yourself warned.
 
 
                Sending backports for the stable branch
                
+
                
 By default merge conflicts are resolved by the stable-release manager. In which
 case he/she should provide a comment about the changes required, alongside the
 Conflicts section. Summary of which will be provided in the
 pre-release announcement.
-
                
+
                
+
+
                
 Developers are interested in sending backports are recommended to use either a
 [BACKPORT #branch] subject prefix or provides similar information
 within the commit summary.
+
                
 
 
                Git tips
                
 
diff --git a/docs/thanks.html b/docs/thanks.html
index 19bb83ee604..310e3afff6f 100644
--- a/docs/thanks.html
+++ b/docs/thanks.html
@@ -23,29 +23,24 @@ This list is far from complete and somewhat dated, unfortunately.
 
 
 
                  
+
 
                • Early Mesa development was done while Brian was part of the
 
 SSEC Visualization Project at the University of
 Wisconsin. He'd like to thank Bill Hibbard for letting him work on
 Mesa as part of that project.
-
                  
-
                  
+
 
                • John Carmack of id Software, Inc. funded Keith Whitwell in 1999 in
 order to optimize Mesa's vertex transformation module. This is a very
 substantial piece of work.
-
                  
-
                  
+
 
                • Precision Insight, Inc., VA Linux Systems, Inc., and most recently,
 Tungsten Graphics, Inc. have supported the ongoing development of Mesa.
-
                  
-
                  
+
 
                • The
 Mesa
 website and git repository are hosted by
 freedesktop.org.
-
                  
-
                  
-
 
 
                • alt.software contributed the Direct3D driver.
 
diff --git a/docs/vmware-guest.html b/docs/vmware-guest.html
index dcc02c1e9c1..65a9aa7149f 100644
--- a/docs/vmware-guest.html
+++ b/docs/vmware-guest.html
@@ -166,9 +166,10 @@ To get the latest code from git:
 
 
                    
 
                  • 
+
                    
 Determine where the GL-related libraries reside on your system and set
 the LIBDIR environment variable accordingly.
-

                    
+
                    
 For 32-bit Ubuntu systems:
 
                       export LIBDIR=/usr/lib/i386-linux-gnu
@@ -195,12 +196,14 @@ For 64-bit Fedora systems:
   ninja -C builddir
   sudo ninja -C builddir install
   
                    
-
                  • Build Mesa and the vmwgfx_dri.so driver, the vmwgfx_drv.so xorg driver, the X acceleration library libxatracker.
+
                  • 
+
                    Build Mesa and the vmwgfx_dri.so driver, the vmwgfx_drv.so xorg driver, the X acceleration library libxatracker.
 The vmwgfx_dri.so is used by the OpenGL libraries during direct rendering,
 and by the Xorg server during accelerated indirect GL rendering.
 The libxatracker library is used exclusively by the X server to do render,
 copy and video acceleration:
-
                    
+
                    
+
 The following configure options doesn't build the EGL system.
   
                       cd $TOP/mesa
@@ -209,10 +212,10 @@ The following configure options doesn't build the EGL system.
   sudo ninja -C builddir install
   
                    
 
+
                    
 Note that you may have to install other packages that Mesa depends upon
 if they're not installed in your system.  You should be told what's missing.
-
                    
-
                    
+
                    
 
 
                  • xf86-video-vmware: Now, once libxatracker is installed, we proceed with
 building and replacing the current Xorg driver.
-- 
cgit v1.2.3