Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
2012/6/13 Ian Romanick i...@freedesktop.org:
On 06/11/2012 09:06 AM, Brian Paul wrote:
On 06/10/2012 04:57 AM, Andreas Boll wrote:
@ release manager
Is there a script for converting the git shortlog into html in
relnotes-*.html or are they converted by hand?
The reason I'm asking is that not all html special chars are correctly
escaped and the changes are not well-formed.
I'm not sure how Ian's been doing that. If any sort of git/sh script is
used, it should probably be checked into the tree or documented with the
rest of the new-release instructions.
Ian?
I have a script, which I've attached. It's not perfect, but it seems to
work pretty well.
Nice script!
This diff fixes my complaints.
Do you want to check this script with my modifications into the git repo?
diff --git a/bin/shortlog_mesa.sh b/bin/shortlog_mesa.sh
index 6825937..7ee1ab9 100755
--- a/bin/shortlog_mesa.sh
+++ b/bin/shortlog_mesa.sh
@@ -6,15 +6,15 @@ typeset -i in_log=0
git shortlog $* | while read l
do
if [ $in_log -eq 0 ]; then
- echo 'p'$l
+ echo 'p'$l'/p'
echo 'ul'
in_log=1
elif echo $l | egrep -q '^$' ; then
- echo '/ul/p'
+ echo '/ul'
echo
in_log=0
else
-mesg=$(echo $l | sed 's/ (cherry picked from commit
[0-9a-f]\+)//;s/\/amp;/g;s//\lt/g;s//\
+mesg=$(echo $l | sed 's/ (cherry picked from commit
[0-9a-f]\+)//;s/\/amp;/g;s//\lt;/g;s//
echo ' li'${mesg}'/li'
fi
done
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
On 06/13/2012 01:37 AM, Andreas Boll wrote: 2012/6/13 Ian Romanicki...@freedesktop.org: On 06/11/2012 09:06 AM, Brian Paul wrote: On 06/10/2012 04:57 AM, Andreas Boll wrote: @ release manager Is there a script for converting the git shortlog into html in relnotes-*.html or are they converted by hand? The reason I'm asking is that not all html special chars are correctly escaped and the changes are not well-formed. I'm not sure how Ian's been doing that. If any sort of git/sh script is used, it should probably be checked into the tree or documented with the rest of the new-release instructions. Ian? I have a script, which I've attached. It's not perfect, but it seems to work pretty well. Nice script! This diff fixes my complaints. Do you want to check this script with my modifications into the git repo? Sounds good to me. I'll do so later if there's no objection. -Brian ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
On 06/13/2012 01:37 AM, Andreas Boll wrote:
2012/6/13 Ian Romanicki...@freedesktop.org:
On 06/11/2012 09:06 AM, Brian Paul wrote:
On 06/10/2012 04:57 AM, Andreas Boll wrote:
@ release manager
Is there a script for converting the git shortlog into html in
relnotes-*.html or are they converted by hand?
The reason I'm asking is that not all html special chars are correctly
escaped and the changes are not well-formed.
I'm not sure how Ian's been doing that. If any sort of git/sh script is
used, it should probably be checked into the tree or documented with the
rest of the new-release instructions.
Ian?
I have a script, which I've attached. It's not perfect, but it seems to
work pretty well.
Nice script!
This diff fixes my complaints.
Do you want to check this script with my modifications into the git repo?
diff --git a/bin/shortlog_mesa.sh b/bin/shortlog_mesa.sh
index 6825937..7ee1ab9 100755
--- a/bin/shortlog_mesa.sh
+++ b/bin/shortlog_mesa.sh
@@ -6,15 +6,15 @@ typeset -i in_log=0
git shortlog $* | while read l
do
if [ $in_log -eq 0 ]; then
- echo 'p'$l
+ echo 'p'$l'/p'
echo 'ul'
in_log=1
elif echo $l | egrep -q '^$' ; then
- echo '/ul/p'
+ echo '/ul'
echo
in_log=0
else
-mesg=$(echo $l | sed 's/ (cherry picked from commit
[0-9a-f]\+)//;s/\/amp;/g;s//\lt/g;s//\
+mesg=$(echo $l | sed 's/ (cherry picked from commit
[0-9a-f]\+)//;s/\/amp;/g;s//\lt;/g;s//
echo 'li'${mesg}'/li'
fi
done
Hmmm, the patch doesn't apply. It looks like the 3rd change's lines
are truncated.
Can you try again or post the entire patched script?
-Brian
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
2012/6/13 Brian Paul bri...@vmware.com:
On 06/13/2012 01:37 AM, Andreas Boll wrote:
2012/6/13 Ian Romanicki...@freedesktop.org:
On 06/11/2012 09:06 AM, Brian Paul wrote:
On 06/10/2012 04:57 AM, Andreas Boll wrote:
@ release manager
Is there a script for converting the git shortlog into html in
relnotes-*.html or are they converted by hand?
The reason I'm asking is that not all html special chars are correctly
escaped and the changes are not well-formed.
I'm not sure how Ian's been doing that. If any sort of git/sh script is
used, it should probably be checked into the tree or documented with the
rest of the new-release instructions.
Ian?
I have a script, which I've attached. It's not perfect, but it seems to
work pretty well.
Nice script!
This diff fixes my complaints.
Do you want to check this script with my modifications into the git repo?
diff --git a/bin/shortlog_mesa.sh b/bin/shortlog_mesa.sh
index 6825937..7ee1ab9 100755
--- a/bin/shortlog_mesa.sh
+++ b/bin/shortlog_mesa.sh
@@ -6,15 +6,15 @@ typeset -i in_log=0
git shortlog $* | while read l
do
if [ $in_log -eq 0 ]; then
- echo 'p'$l
+ echo 'p'$l'/p'
echo 'ul'
in_log=1
elif echo $l | egrep -q '^$' ; then
- echo '/ul/p'
+ echo '/ul'
echo
in_log=0
else
- mesg=$(echo $l | sed 's/ (cherry picked from commit
[0-9a-f]\+)//;s/\/amp;/g;s//\lt/g;s//\
+ mesg=$(echo $l | sed 's/ (cherry picked from commit
[0-9a-f]\+)//;s/\/amp;/g;s//\lt;/g;s//
echo 'li'${mesg}'/li'
fi
done
Hmmm, the patch doesn't apply. It looks like the 3rd change's lines are
truncated.
Can you try again or post the entire patched script?
-Brian
I have attached the entire patched script.
shortlog_mesa.sh
Description: Bourne shell script
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
Cc: Ian 2012/6/11 Andreas Boll andreas.boll@gmail.com: 2012/6/11 Brian Paul bri...@vmware.com: On 06/10/2012 04:57 AM, Andreas Boll wrote: Hi, the following patch series is the first part of cleaning up docs/. Please review and commit. Please commit/push. I don't have commit access. I'm not an HTML expert but these look ok to me. Can you commit/push or should I? Q: are lower-case html tags recommended or the usual convention or just your personal preference? Just wondering. Lower-case is recommended, because it's more future-proof wrt. XHTML where lower-case tags are required. I think nowadays it's the usual convention. You should either use upper- or lower-case tags to be consistent. So I'm tending to write lower-case only and it's definitly less use of the shift key ;) The next steps are: - finish html cleanup (more well-formed html) Tools I'm using: * http://validator.w3.org/ * http://tidy.sourceforge.net/ - update docs content - drop obsolete docs OK. @ release manager Is there a script for converting the git shortlog into html in relnotes-*.html or are they converted by hand? The reason I'm asking is that not all html special chars are correctly escaped and the changes are not well-formed. I'm not sure how Ian's been doing that. If any sort of git/sh script is used, it should probably be checked into the tree or documented with the rest of the new-release instructions. Ian? -Brian ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
On 06/11/2012 11:18 AM, Andreas Boll wrote: 2012/6/11 Brian Paul bri...@vmware.com: On 06/10/2012 04:57 AM, Andreas Boll wrote: Hi, the following patch series is the first part of cleaning up docs/. Please review and commit. Please commit/push. I don't have commit access. I'm not an HTML expert but these look ok to me. Can you commit/push or should I? Q: are lower-case html tags recommended or the usual convention or just your personal preference? Just wondering. Lower-case is recommended, because it's more future-proof wrt. XHTML where lower-case tags are required. I think nowadays it's the usual convention. Yeah. XHTML (HTML on top of XML instead of SGML) requires lowercase tags, so basically everyone uses that these days. I'm actually kind of surprised you went with HTML 4 transitional rather than XHTML or HTML strict. But it's not a big deal either way. ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
2012/6/12 Kenneth Graunke kenn...@whitecape.org: On 06/11/2012 11:18 AM, Andreas Boll wrote: 2012/6/11 Brian Paul bri...@vmware.com: On 06/10/2012 04:57 AM, Andreas Boll wrote: Hi, the following patch series is the first part of cleaning up docs/. Please review and commit. Please commit/push. I don't have commit access. I'm not an HTML expert but these look ok to me. Can you commit/push or should I? Q: are lower-case html tags recommended or the usual convention or just your personal preference? Just wondering. Lower-case is recommended, because it's more future-proof wrt. XHTML where lower-case tags are required. I think nowadays it's the usual convention. Yeah. XHTML (HTML on top of XML instead of SGML) requires lowercase tags, so basically everyone uses that these days. I'm actually kind of surprised you went with HTML 4 transitional rather than XHTML or HTML strict. But it's not a big deal either way. HTML transitional is the way to go, if you want to upgrade from legacy HTML with minimal effort, cause the strict variant removes some deprecated tags and attributes like 'frame' and 'target', which are needed for the frame based layout of mesa. So for upgrading to strict we would have to get rid of the frame based layout and fix the validation errors introduced by strict first. Another variant is the XHTML transitional. But before using this variant we would have to ensure that the markup is XML valid, which roughly means each opening tag needs a closing one. And there are a lot of missing end tags in the docs, which are optional in HTML (SGML). However this can be achieved with incremental improvement of the current markup and once these problems are solved, we can upgrade to strict or rather to XHTML strict. ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
On 06/10/2012 04:57 AM, Andreas Boll wrote: Hi, the following patch series is the first part of cleaning up docs/. Please review and commit. I'm not an HTML expert but these look ok to me. Can you commit/push or should I? Q: are lower-case html tags recommended or the usual convention or just your personal preference? Just wondering. The next steps are: - finish html cleanup (more well-formed html) Tools I'm using: * http://validator.w3.org/ * http://tidy.sourceforge.net/ - update docs content - drop obsolete docs OK. @ release manager Is there a script for converting the git shortlog into html in relnotes-*.html or are they converted by hand? The reason I'm asking is that not all html special chars are correctly escaped and the changes are not well-formed. I'm not sure how Ian's been doing that. If any sort of git/sh script is used, it should probably be checked into the tree or documented with the rest of the new-release instructions. Ian? -Brian ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
Re: [Mesa-dev] [PATCH 00/11] docs: html cleanup
2012/6/11 Brian Paul bri...@vmware.com: On 06/10/2012 04:57 AM, Andreas Boll wrote: Hi, the following patch series is the first part of cleaning up docs/. Please review and commit. Please commit/push. I don't have commit access. I'm not an HTML expert but these look ok to me. Can you commit/push or should I? Q: are lower-case html tags recommended or the usual convention or just your personal preference? Just wondering. Lower-case is recommended, because it's more future-proof wrt. XHTML where lower-case tags are required. I think nowadays it's the usual convention. You should either use upper- or lower-case tags to be consistent. So I'm tending to write lower-case only and it's definitly less use of the shift key ;) The next steps are: - finish html cleanup (more well-formed html) Tools I'm using: * http://validator.w3.org/ * http://tidy.sourceforge.net/ - update docs content - drop obsolete docs OK. @ release manager Is there a script for converting the git shortlog into html in relnotes-*.html or are they converted by hand? The reason I'm asking is that not all html special chars are correctly escaped and the changes are not well-formed. I'm not sure how Ian's been doing that. If any sort of git/sh script is used, it should probably be checked into the tree or documented with the rest of the new-release instructions. Ian? -Brian ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
[Mesa-dev] [PATCH 00/11] docs: html cleanup
Hi, the following patch series is the first part of cleaning up docs/. Please review and commit. The next steps are: - finish html cleanup (more well-formed html) Tools I'm using: * http://validator.w3.org/ * http://tidy.sourceforge.net/ - update docs content - drop obsolete docs @ release manager Is there a script for converting the git shortlog into html in relnotes-*.html or are they converted by hand? The reason I'm asking is that not all html special chars are correctly escaped and the changes are not well-formed. e.g. relnotes-8.0.3.html: pAlban Browaeys (1): ul lidri/i915: Fix off-by-one in i830 clip region size./li /ul/p well-formed html: pAlban Browaeys (1):/p ul lidri/i915: Fix off-by-one in i830 clip region size./li /ul Andreas. Andreas Boll (11): docs: consolidate html header and footer docs: escape special html chars docs: fix html end/start tags docs/news.html: use proper markup docs/subset-A.html: fix markup docs: use id instead of a name docs: prefer lowercase html tags docs: remove unused anchor links docs: remove unused table styles docs: remove some superfluous p tags docs: whitespaces cleanup docs/autoconf.html| 15 ++-- docs/banner.html | 52 ++- docs/bugs.html| 22 +++--- docs/conform.html | 19 ++-- docs/contents.html| 74 docs/debugging.html | 21 +++-- docs/developers.html | 19 ++-- docs/devinfo.html | 33 docs/dispatch.html| 50 +-- docs/download.html| 25 +++--- docs/egl.html | 13 ++-- docs/envvars.html | 34 +++ docs/extensions.html | 54 ++-- docs/faq.html | 87 +-- docs/games.html | 25 +++--- docs/glu.html | 19 ++-- docs/helpwanted.html | 25 +++--- docs/index.html |8 +- docs/install.html | 59 ++--- docs/intro.html | 35 docs/libraries.html | 20 +++-- docs/license.html | 23 +++--- docs/lists.html | 42 - docs/llvmpipe.html| 37 docs/mangling.html| 23 +++--- docs/modelers.html| 20 +++-- docs/news.html| 214 docs/opengles.html| 13 ++-- docs/openvg.html | 21 ++--- docs/osmesa.html | 25 +++--- docs/perf.html| 23 +++--- docs/postprocess.html | 23 +++--- docs/precompiled.html | 21 +++-- docs/relnotes-6.4.1.html |2 +- docs/relnotes-6.5.2.html |2 +- docs/relnotes-7.1.html|2 +- docs/relnotes-7.10.1.html |4 +- docs/relnotes-7.10.3.html |6 +- docs/relnotes-7.10.html | 12 ++-- docs/relnotes-7.11.html |2 +- docs/relnotes-7.9.1.html |8 +- docs/relnotes-7.9.2.html |1 - docs/relnotes-8.0.2.html |2 +- docs/relnotes-8.0.3.html |4 +- docs/relnotes.html| 161 +- docs/repository.html | 37 docs/science.html | 24 +++--- docs/shading.html | 55 +--- docs/sourcedocs.html | 29 +++--- docs/sourcetree.html | 19 ++-- docs/subset-A.html| 18 ++--- docs/subset.html | 21 +++-- docs/systems.html | 23 +++--- docs/thanks.html | 35 docs/utilities.html | 19 ++-- docs/utility.html | 19 ++-- docs/versions.html| 89 +-- docs/viewperf.html| 19 ++-- docs/vmware-guest.html| 18 ++-- docs/webmaster.html | 19 ++-- docs/xlibdriver.html | 35 61 files changed, 930 insertions(+), 949 deletions(-) ___ mesa-dev mailing list mesa-dev@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/mesa-dev
