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 <erik.faye-lund@collabora.com>
Reviewed-by: Emil Velikov <emil.velikov@collabora.com>
Reviewed-by: Eric Engestrom <eric.engestrom@intel.com>

docs/envvars.html

@@ -52,11 +52,8 @@ sometimes be useful for debugging end-user issues.
 <li>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.<br>
+   printed to stderr. For release builds, MESA_DEBUG defaults to off (no debug
-
+   output). MESA_DEBUG accepts the following comma-separated list of named
-   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:
    <ul>
      <li>silent - turn off debug messages. Only useful for debug builds.</li>

docs/index.html

@@ -43,7 +43,8 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/18.3.6.html">Mesa 18.3.6</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/18.2.8.html">Mesa 18.2.8</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/18.1.9.html">Mesa 18.1.9</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/18.0.5.html">Mesa 18.0.5</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/17.3.9.html">Mesa 17.3.9</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/17.2.8.html">Mesa 17.2.8</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/17.1.10.html">Mesa 17.1.10</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/17.0.7.html">Mesa 17.0.7</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <a href="relnotes/17.0.2.html">Mesa 17.0.2</a> are released.
 
 These are bug-fix releases from the 13.0 and 17.0 branches, respectively.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/12.0.6.html">Mesa 12.0.6</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/12.0.5.html">Mesa 12.0.5</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <a href="relnotes/11.2.2.html">Mesa 11.2.2</a> are released.
 
 These are bug-fix releases from the 11.1 and 11.2 branches, respectively.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/11.0.9.html">Mesa 11.0.9</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/10.6.9.html">Mesa 10.6.9</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/10.5.9.html">Mesa 10.5.9</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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 <a href="relnotes/10.4.2.html">Mesa 10.4.2</a> are released.
 
 These are bug-fix releases from the 10.3 and 10.4 branches, respectively.
-<br>
+</p>
+<p>
 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 <a href="relnotes/10.3.1.html">Mesa 10.3.1</a> are released.
 
 These are bug-fix releases from the 10.2 and 10.3 branches, respectively.
-<br>
+</p>
+<p>
 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.
 <p>
 <a href="relnotes/10.0.5.html">Mesa 10.0.5</a> is released.
 This is a bug-fix release.
-<br>
+</p>
+<p>
 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:</p>
 
 <h2>April 29, 2001</h2>
 <p>New Mesa website</p>
-<p>Mark Manning produced the new website.<br>Thanks, Mark!</p>
+<p>Mark Manning produced the new website. Thanks, Mark!</p>
 
 
 <h2>February 14, 2001</h2>
@@ -2477,8 +2495,9 @@ just bug fixes.</p>
 </pre>
 
 <p>Please report any problems with this release ASAP. Bugs should be filed on the
-Mesa3D website at sourceforge.<br>
+Mesa3D website at sourceforge.
-After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.</p>
+</p>
+<p>After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.</p>
 <p>-- Brian</p>
 
 <h2>December 17, 1999</h2>

docs/precompiled.html

@@ -22,9 +22,8 @@ In general, precompiled Mesa libraries are not available.
 <p>
 Some Linux distributions closely follow the latest Mesa releases. On others one
 has to use unofficial channels.
-<br>
-There are some general directions:
 </p>
+<p>There are some general directions:</p>
 <ul>
 <li>Debian/Ubuntu based distros - PPA: xorg-edgers, oibaf and padoka</li>
 <li>Fedora - Corp: erp and che</li>

docs/release-calendar.html

@@ -21,20 +21,29 @@
 <p>
 Mesa provides feature/development and stable releases.
 </p>
+
 <p>
 The table below lists the date and release manager that is expected to do the
 specific release.
-<br>
+</p>
-Regular updates will ensure that the schedule for the current and the
+
-next two feature releases are shown in the table.
+<p>
-<br>
+Regular updates will ensure that the schedule for the current and the next two
-In order to keep the whole releasing team up to date with the tools
+feature releases are shown in the table.
-used, best practices and other details, the member in charge of the
+</p>
-next feature release will be in constant rotation.
+
-<br>
+<p>
-The way the release schedule works is
+In order to keep the whole releasing team up to date with the tools used, best
-explained <a href="releasing.html#schedule" target="_parent">here</a>.
+practices and other details, the member in charge of the next feature release
-<br>
+will be in constant rotation.
+</p>
+
+<p>
+The way the release schedule works is explained
+<a href="releasing.html#schedule" target="_parent">here</a>.
+</p
+>
+<p>
 Take a look <a href="submittingpatches.html#criteria" target="_parent">here</a>
 if you'd like to nominate a patch in the next stable release.
 </p>

docs/releasing.html

@@ -36,7 +36,9 @@
 <p>
 This document uses the convention X.Y.Z for the release number with X.Y being
 the stable branch name.
-<br>
+</p>
+
+<p>
 Mesa provides feature and bugfix releases. Former use zero as patch version (Z),
 while the latter have a non-zero one.
 </p>
@@ -57,7 +59,9 @@ For example:
 <p>
 Releases should happen on Wednesdays. Delays can occur although those
 should be kept to a minimum.
-<br>
+</p>
+
+<p>
 See our <a href="release-calendar.html" target="_parent">calendar</a>
 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.
 
 <p>
 Note: There is one or two releases overlap when changing branches. For example:
-<br>
+</p>
+
+<p>
 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.
-<br>
+</p>
+
+<p>
 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.
 
 <p>
 <strong>Note:</strong> If a patch in the current queue needs any additional
-fix(es), then they should be squashed together.
+fix(es), then they should be squashed together. The commit messages and the
-<br>
+<code>cherry picked from</code> tags must be preserved.
-The commit messages and the <code>cherry picked from</code> tags must be preserved.
 </p>
 
 <p>
@@ -252,9 +259,8 @@ stabilisation and bugfixing.
 
 <p>
 Note: Before doing a branch ensure that basic build and <code>meson test</code>
-testing is done and there are little to-no issues.
+testing is done and there are little to-no issues. Ideally all of those should
-<br>
+be tackled already.
-Ideally all of those should be tackled already.
 </p>
 
 <p>
@@ -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.
-<br>
+</p>
+<p>
 It is followed by a brief period (normally 24 or 48 hours) before the actual
 release is made.
 </p>
@@ -330,10 +337,8 @@ Barring reported regressions or objections from developers.
 <p>
 Patch does not fit the
 <a href="submittingpatches.html#criteria" target="_parent">criteria</a> and
-is followed by a brief information.
+is followed by a brief information. The release maintainer is human so if you
-<br>
+believe you've spotted a mistake do let them know.
-The release maintainer is human so if you believe you've spotted a mistake do
-let them know.
 </p>
 
 <h2>Format/template</h2>
@@ -623,10 +628,8 @@ website. Manually check that it is updated 5-10 minutes after the final <code>gi
 
 <p>
 Parse through the bugreports as listed in the docs/relnotes/X.Y.Z.html
-document.
+document. If there's outstanding action, close the bug referencing the commit
-<br>
+ID which addresses the bug and mention the Mesa version that has the fix.
-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.
 </p>
 
 <p>

docs/relnotes/6.4.2.html

@@ -43,8 +43,7 @@ fe1523744fc05edc3811dfc6a1bf4181  MesaGLUT-6.4.2.zip
 
 <h2>Changes</h2>
 <ul>
-<li>GLUT tarball
+<li>GLUT tarball:
-<br>
 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.

docs/relnotes/6.5.2.html

@@ -41,10 +41,10 @@ c6d7134843ed5faf11f6686ecb5d2a2e  MesaGLUT-6.5.2.zip
 <li>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.
-<br>
+<p>
 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.
-<br>
+</p>
 New features resulting from this work include:
 <ul>
 <li>EXT_framebuffer_objects, render to texture

docs/relnotes/6.5.html

@@ -39,33 +39,36 @@ ac1d585483617db0c91e5c15cb5ec3a3  MesaGLUT-6.5.tar.gz
 <h2>New Features</h2>
 <ul>
 <li>OpenGL Shading language support
-<br>
+<p>
    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.
-<br>
+</p>
+<p>
    The OpenGL 2.0 interface to these features will be implemented in a
    future version of Mesa,
+</p>
 
 <li>GL_EXT_timer_query
-<br>
+<p>
    Used to measure the time of OpenGL operations at high precision.
    Only supported in the software/Xlib driver at this time.
-
+</p>
 <li>GL_EXT_packed_depth_stencil
-<br>
+<p>
    Defines a new GL_DEPTH_STENCIL_EXT pixel format.
-
+</p>
 <li>GL_EXT_framebuffer_blit
-<br>
+<p>
    A simplified glCopyPixels-like feature for copying pixel rectangles.
-
+</p>
 <li>GL_ARB_half_float_pixel
-<br>
+<p>
    Adds a new half-precision floating point format for image transfers,
    such as for glDrawPixels, glReadPixels, glTexImage, etc.
+</p>
 </ul>
 
 <h2>Changes</h2>

docs/relnotes/9.0.html

@@ -84,7 +84,6 @@ by Khronos.</li>
 <ul>
 <li>
 The legacy/static Makefile system (ex: 'make linux-dri') has been removed.
-<br>
 The two supported build methods are now autoconf/automake and SCons.
 </li>
 <li>Removed support for GL_ARB_shadow_ambient extension</li>

docs/repository.html

@@ -49,7 +49,7 @@ To get the Mesa sources anonymously (read-only):
 </p>
 
 <ol>
-<li>Install the git software on your computer if needed.<br><br>
+<li>Install the git software on your computer if needed.
 <li>Get an initial, local copy of the repository with:
     <pre>
     git clone https://gitlab.freedesktop.org/mesa/mesa.git
@@ -129,7 +129,6 @@ and to LF on commit.
 <p>
 Unix users don't need to set this option.
 </p>
-<br>
 
 
 <h2>Development Branches</h2>
@@ -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.)
-<br>
+</p>
+<p>
 In any case, your repository now looks like you made your changes after
 all the other changes.
 </p>

docs/submittingpatches.html

@@ -118,9 +118,9 @@ patch has already been reviewed.
 <li>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.
-<br>
+<p>
 Please use common sense and do <strong>not</strong> blindly add everyone.
-<br>
+</p>
 <pre>
     $ 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.
 <p>
 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".<br/>
+email is confidential" and "distribution is strictly prohibited".
+</p>
+<p>
 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.
 <p>
 Note: by removing the tag [as the commit is pushed] the patch is
 <strong>explicitly</strong> rejected from inclusion in the stable branch(es).
-<br>
 Thus, drop the line <strong>only</strong> if you want to cancel the nomination.
 </p>
 
@@ -448,14 +449,18 @@ be lost from the stable branch if developers push things directly. Consider
 yourself warned.
 
 <h2 id="backports">Sending backports for the stable branch</h2>
+<p>
 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
 <code>Conflicts</code> section. Summary of which will be provided in the
 <a href="releasing.html#prerelease">pre-release</a> announcement.
-<br>
+</p>
+
+<p>
 Developers are interested in sending backports are recommended to use either a
 <code>[BACKPORT #branch]</code> subject prefix or provides similar information
 within the commit summary.
+</p>
 
 <h2 id="gittips">Git tips</h2>
 

docs/thanks.html

@@ -23,29 +23,24 @@ This list is far from complete and somewhat dated, unfortunately.
 
 
 <ul>
+
 <li>Early Mesa development was done while Brian was part of the
 <a href="https://www.ssec.wisc.edu/~billh/vis.html">
 SSEC Visualization Project</a> at the University of
 Wisconsin. He'd like to thank Bill Hibbard for letting him work on
 Mesa as part of that project.
-<br>
+
-<br>
 <li>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.
-<br>
+
-<br>
 <li>Precision Insight, Inc., VA Linux Systems, Inc., and most recently,
 Tungsten Graphics, Inc. have supported the ongoing development of Mesa.
-<br>
+
-<br>
 <li>The
 <a href="https://www.mesa3d.org">Mesa</a>
 website and git repository are hosted by
 <a href="https://freedesktop.org/">freedesktop.org</a>.
-<br>
-<br>
-
 
 <li><a href="http://www.altsoftware.com/">alt.software</a> contributed the Direct3D driver.
 

docs/vmware-guest.html

@@ -166,9 +166,10 @@ To get the latest code from git:
 
 <ul>
 <li>
+<p>
 Determine where the GL-related libraries reside on your system and set
 the LIBDIR environment variable accordingly.
-<br><br>
+</p>
 For 32-bit Ubuntu systems:
 <pre>
   export LIBDIR=/usr/lib/i386-linux-gnu
@@ -195,12 +196,14 @@ For 64-bit Fedora systems:
   ninja -C builddir
   sudo ninja -C builddir install
   </pre>
-<li>Build Mesa and the vmwgfx_dri.so driver, the vmwgfx_drv.so xorg driver, the X acceleration library libxatracker.
+<li>
+<p>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:
-<br>
+</p>
+
 The following configure options doesn't build the EGL system.
   <pre>
   cd $TOP/mesa
@@ -209,10 +212,10 @@ The following configure options doesn't build the EGL system.
   sudo ninja -C builddir install
   </pre>
 
+<p>
 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.
-<br>
+</p>
-<br>
 
 <li>xf86-video-vmware: Now, once libxatracker is installed, we proceed with
 building and replacing the current Xorg driver.