You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@impala.apache.org by jr...@apache.org on 2016/10/31 21:40:55 UTC
incubator-impala git commit: Amend ditaval comments for the upstream
context, and propagate to PDF-oriented ditaval file.
Repository: incubator-impala
Updated Branches:
refs/heads/doc_prototype 5feac74a0 -> a75cfdf4e
Amend ditaval comments for the upstream context, and propagate to PDF-oriented ditaval file.
Project: http://git-wip-us.apache.org/repos/asf/incubator-impala/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-impala/commit/a75cfdf4
Tree: http://git-wip-us.apache.org/repos/asf/incubator-impala/tree/a75cfdf4
Diff: http://git-wip-us.apache.org/repos/asf/incubator-impala/diff/a75cfdf4
Branch: refs/heads/doc_prototype
Commit: a75cfdf4ea4da79e00baa0ebbd3571f2b1358227
Parents: 5feac74
Author: John Russell <jr...@cloudera.com>
Authored: Mon Oct 31 14:40:50 2016 -0700
Committer: John Russell <jr...@cloudera.com>
Committed: Mon Oct 31 14:40:50 2016 -0700
----------------------------------------------------------------------
docs/impala_html.ditaval | 11 ++++++-----
docs/impala_pdf.ditaval | 12 ++++++++++++
2 files changed, 18 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-impala/blob/a75cfdf4/docs/impala_html.ditaval
----------------------------------------------------------------------
diff --git a/docs/impala_html.ditaval b/docs/impala_html.ditaval
index 2f6b730..079a7ad 100644
--- a/docs/impala_html.ditaval
+++ b/docs/impala_html.ditaval
@@ -1,14 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?><val>
-<!-- Exclude Cloudera-only content -->
+<!-- Exclude Cloudera-only content. This is typically material that's permanently hidden,
+ e.g. obsolete or abandoned. Use pre-release for material being actively worked on
+ that's not ready for prime time. -->
<prop att="audience" val="Cloudera" action="exclude"/>
<!-- These two are backward: things marked HTML are excluded from the HTML and
things marked PDF are excluded from the PDF. -->
<prop att="audience" val="HTML" action="exclude"/>
<prop att="audience" val="PDF" action="include"/>
-<!-- Content marked OFFLINE is intended for the CM bundled documentation -->
-<prop att="audience" val="offline" action="exclude"/>
-<!-- These two are for Impala and Search, to allow for differences in standalone
- docs versus those which are included in CDH -->
+<!-- standalone = upstream Impala docs, not part of any larger library
+ integrated = any xrefs, topicrefs, or other residue from original downstream docs
+ that don't resolve properly in the upstream context -->
<prop att="audience" val="integrated" action="include"/>
<prop att="audience" val="standalone" action="exclude"/>
<!-- John added this so he can work on Impala_Next in master without fear that
http://git-wip-us.apache.org/repos/asf/incubator-impala/blob/a75cfdf4/docs/impala_pdf.ditaval
----------------------------------------------------------------------
diff --git a/docs/impala_pdf.ditaval b/docs/impala_pdf.ditaval
index a876a05..c0f3b8e 100644
--- a/docs/impala_pdf.ditaval
+++ b/docs/impala_pdf.ditaval
@@ -1,9 +1,21 @@
<?xml version="1.0" encoding="UTF-8"?><val>
+<!-- Exclude Cloudera-only content. This is typically material that's permanently hidden,
+ e.g. obsolete or abandoned. Use pre-release for material being actively worked on
+ that's not ready for prime time. -->
<prop att="audience" val="Cloudera" action="exclude"/>
+<!-- These two are backward: things marked HTML are excluded from the HTML and
+ things marked PDF are excluded from the PDF. -->
<prop att="audience" val="PDF" action="exclude"/>
<prop att="audience" val="HTML" action="include"/>
+<!-- standalone = upstream Impala docs, not part of any larger library
+ integrated = any xrefs, topicrefs, or other residue from original downstream docs
+ that don't resolve properly in the upstream context -->
<prop att="audience" val="integrated" action="exclude"/>
<prop att="audience" val="standalone" action="include"/>
+<!-- John added this so he can work on Impala_Next in master without fear that
+ it will show up too early in released docs -->
<prop att="audience" val="impala_next" action="exclude"/>
+<!-- This DITAVAL specifically EXCLUDES things marked pre-release -->
+<!-- It is safe to use for generating public artifacts. -->
<prop att="audience" val="pre-release" action="exclude"/>
</val>