[PATCH] Clarify the web services sections in the quick guide

[Marko Myllynen <myllynen@xxxxxxxxxx>]

Hi,

below is an attempt to clarify the web services sections in the Quick Reference 
Guide a bit now that we have first builds available.


---
 man/html/guide.html |   16 +++++++---------
 1 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/man/html/guide.html b/man/html/guide.html
index db78c6c..a143655 100644
--- a/man/html/guide.html
+++ b/man/html/guide.html
@@ -475,7 +475,10 @@ This example shows a PMIE script, checks its syntax, runs 
it against an archive,
 <a name="web"></a>
 <H1>PCP Web Services</H1>
 
-<P>A daemon for exporting PCP metrics using a REST web service (over 
HTTP/JSON) is also available.  Use this for viewing or monitoring PCP metrics 
in a web browser - several web interfaces are becoming available (also via the 
pcp-webapi package) to make this a reality.
+<a name="pmwebd"></a>
+<H3>Performance Metrics Web Daemon</H3>
+
+<P>Performance Metrics Web Daemon (<a 
href="http://man7.org/linux/man-pages/man1/pmwebd.1.html";>pmwebd(1)</a>) is a 
front-end to both PMCD and PCP archives, providing a REST web service (over 
HTTP/JSON) suitable for use by web-based tools wishing to access performance 
data over HTTP. Custom applications can access all the available PCP 
information using this method, including custom metrics generated by custom 
PMDAs.
 
 <TABLE WIDTH="100%" BORDER=0 CELLPADDING=10 CELLSPACING=20>
         <TR><TD BGCOLOR="#e2e2e2" WIDTH="70%"><BR><IMG 
SRC="images/stepfwd_on.png" ALT="" WIDTH=16 HEIGHT=16 
BORDER=0>&nbsp;&nbsp;&nbsp;To install the PCP web service on Fedora/RHEL:<br><B>
@@ -490,17 +493,12 @@ This example shows a PMIE script, checks its syntax, runs 
it against an archive,
 </B></TD></TR>
 </TABLE>
 
-<a name="pmwebd"></a>
-<H3>Performance Metrics Web Daemon</H3>
-
-<P>Performance Metrics Web Daemon (<a 
href="http://man7.org/linux/man-pages/man1/pmwebd.1.html";>pmwebd(1)</a>) is a 
front-end to both PMCD and PCP archives, providing a JSON interface suitable 
for use by web-based tools wishing to access performance data over HTTP. Custom 
applications can access all the available PCP information using this method, 
including custom metrics generated by custom PMDAs.
-
 <a name="browse"></a>
-<H3>Web Interface for Performance Metrics</H3>
+<H3>User Web Interface for Performance Metrics</H3>
 
-<P>Several browser interfaces for accessing PCP performance metrics are 
available.  These web interfaces make PCP metrics available via your choice of 
<A HREF="http://grafana.org/";>Grafana</A> or <A 
HREF="http://graphite.wikidot.com/";>Graphite</A>.
+<P>Several browser interfaces for accessing PCP performance metrics are also 
available. These web interfaces make PCP metrics available via your choice of 
<A HREF="http://grafana.org/";>Grafana</A> or <A 
HREF="http://graphite.wikidot.com/";>Graphite</A>.
 
-<P>Install the PCP web services daemon as described above, and the contents of 
the <B>pcp-webjs</B> package (platform-independent HTML and Javascript) into 
/usr/share/pcp/webapps, then point a browser toward <a 
href="http://localhost:44323";>http://localhost:44323</a>.
+<P>After installing the PCP web services daemon as described above, install 
the pcp-webjs package and then just point a browser toward <a 
href="http://localhost:44323";>http://localhost:44323</a>.
 
 <a name="custom"></a>
 <H1>Customizing and Extending PCP</H1>
-- 
1.7.1

-- 
Marko Myllynen