MIME-Version: 1.0
In-Reply-To: <1341606781.7092.0.camel@vanquo.pezone.net>
References: 
 <CAK3UJRHJvGJZW80S3=5HJ0TMG5QmkXH5YaTS2K_0-9kQKP-a5g@mail.gmail.com>
	<1341606781.7092.0.camel@vanquo.pezone.net>
From: Josh Kupershmidt <schmiddy@gmail.com>
Date: Fri, 6 Jul 2012 14:09:00 -0700
Message-ID: 
 <CAK3UJRFe51f_4Sc0a-QK6uTsXLMHtyV7cmKQJX13gAbs0qVGCw@mail.gmail.com>
Subject: Re: pgtesttiming.sgml, FreeBSD command output
To: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Content-Type: multipart/mixed; boundary=e89a8ff2501486314f04c42fad23

--e89a8ff2501486314f04c42fad23
Content-Type: text/plain; charset=ISO-8859-1

On Fri, Jul 6, 2012 at 1:33 PM, Peter Eisentraut <peter_e@gmx.net> wrote:
> On fre, 2012-07-06 at 13:21 -0700, Josh Kupershmidt wrote:

>> <screen>
>> dmesg | grep "Timecounter"
>> sysctl kern.timecounter.hardware=TSC
>> </screen>
>>
>> First, grep is case-sensitive by default, so that line of output
>> shouldn't have matched at all, right?
>
> I don't think this was meant to say that the second line is the output
> of the first.  I read this as two separate commands.  But I agree this
> part is a bit unclear.

Oh, I see now. The <screen> sections above and below that one were
including output, and I was just expecting the same here.

One way to fix would be to include shell prompts and outputs for both
commands (patch Option 1, attached).  Or, if we don't want to bother
including output, as the section does now, maybe we could at least
include the shell prompts and mention that output is excluded (patch
Option 2).

I've also attached an unrelated typofix I noticed for the same page.

Josh

--e89a8ff2501486314f04c42fad23
Content-Type: application/octet-stream; name="pgtesttiming_typofix.diff"
Content-Disposition: attachment; filename="pgtesttiming_typofix.diff"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_h4bqzzo50

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9wZ3Rlc3R0aW1pbmcuc2dtbCBiL2RvYy9zcmMvc2dt
bC9wZ3Rlc3R0aW1pbmcuc2dtbApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCBmNzRkNjNlLi5m
Y2Q4OTk2CioqKiBhL2RvYy9zcmMvc2dtbC9wZ3Rlc3R0aW1pbmcuc2dtbAotLS0gYi9kb2Mvc3Jj
L3NnbWwvcGd0ZXN0dGltaW5nLnNnbWwKKioqKioqKioqKioqKioqIEhpc3RvZ3JhbSBvZiB0aW1p
bmcgZHVyYXRpb25zOgoqKiogMjc3LDI4MyAqKioqCiAgICA8L3BhcmE+CiAgCiAgICA8cGFyYT4K
ISAgICBUaW1lcnMgdXNlZCBvbiBvbGRlciBQQyBoYXJkd2FyZSBpbmNsdWRpbmcgdGhlIDgyNTQg
UHJvZ3JhbW1hYmxlIEludGVydmFsCiAgICAgVGltZXIgKFBJVCksIHRoZSByZWFsLXRpbWUgY2xv
Y2sgKFJUQyksIHRoZSBBZHZhbmNlZCBQcm9ncmFtbWFibGUgSW50ZXJydXB0CiAgICAgQ29udHJv
bGxlciAoQVBJQykgdGltZXIsIGFuZCB0aGUgQ3ljbG9uZSB0aW1lci4gIFRoZXNlIHRpbWVycyBh
aW0gZm9yCiAgICAgbWlsbGlzZWNvbmQgcmVzb2x1dGlvbi4KLS0tIDI3NywyODMgLS0tLQogICAg
PC9wYXJhPgogIAogICAgPHBhcmE+CiEgICAgVGltZXJzIHVzZWQgb24gb2xkZXIgUEMgaGFyZHdh
cmUgaW5jbHVkZSB0aGUgODI1NCBQcm9ncmFtbWFibGUgSW50ZXJ2YWwKICAgICBUaW1lciAoUElU
KSwgdGhlIHJlYWwtdGltZSBjbG9jayAoUlRDKSwgdGhlIEFkdmFuY2VkIFByb2dyYW1tYWJsZSBJ
bnRlcnJ1cHQKICAgICBDb250cm9sbGVyIChBUElDKSB0aW1lciwgYW5kIHRoZSBDeWNsb25lIHRp
bWVyLiAgVGhlc2UgdGltZXJzIGFpbSBmb3IKICAgICBtaWxsaXNlY29uZCByZXNvbHV0aW9uLgo=
--e89a8ff2501486314f04c42fad23
Content-Type: application/octet-stream;
	name="pgtesttiming_output_Option2.diff"
Content-Disposition: attachment; filename="pgtesttiming_output_Option2.diff"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_h4bqzzoa1

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9wZ3Rlc3R0aW1pbmcuc2dtbCBiL2RvYy9zcmMvc2dt
bC9wZ3Rlc3R0aW1pbmcuc2dtbApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCBmNzRkNjNlLi4w
NTU0MzE2CioqKiBhL2RvYy9zcmMvc2dtbC9wZ3Rlc3R0aW1pbmcuc2dtbAotLS0gYi9kb2Mvc3Jj
L3NnbWwvcGd0ZXN0dGltaW5nLnNnbWwKKioqKioqKioqKioqKioqIEhpc3RvZ3JhbSBvZiB0aW1p
bmcgZHVyYXRpb25zOgoqKiogMTgwLDE5MCAqKioqCiAgCiAgICA8cGFyYT4KICAgICBGcmVlQlNE
IGFsc28gYWxsb3dzIGNoYW5naW5nIHRoZSB0aW1lIHNvdXJjZSBvbiB0aGUgZmx5LCBhbmQgaXQg
bG9ncwohICAgIGluZm9ybWF0aW9uIGFib3V0IHRoZSB0aW1lciBzZWxlY3RlZCBkdXJpbmcgYm9v
dDoKICAKICA8c2NyZWVuPgohIGRtZXNnIHwgZ3JlcCAiVGltZWNvdW50ZXIiCiEgc3lzY3RsIGtl
cm4udGltZWNvdW50ZXIuaGFyZHdhcmU9VFNDCiAgPC9zY3JlZW4+CiAgICA8L3BhcmE+CiAgCi0t
LSAxODAsMTkxIC0tLS0KICAKICAgIDxwYXJhPgogICAgIEZyZWVCU0QgYWxzbyBhbGxvd3MgY2hh
bmdpbmcgdGhlIHRpbWUgc291cmNlIG9uIHRoZSBmbHksIGFuZCBpdCBsb2dzCiEgICAgaW5mb3Jt
YXRpb24gYWJvdXQgdGhlIHRpbWVyIHNlbGVjdGVkIGR1cmluZyBib290IChvdXRwdXRzIG9mIHRo
ZXNlIHR3bwohICAgIGNvbW1hbmRzIGFyZSBvbWl0dGVkIGZvciBicmV2aXR5KToKICAKICA8c2Ny
ZWVuPgohICMgZG1lc2cgfCBncmVwICJUaW1lY291bnRlciIKISAjIHN5c2N0bCBrZXJuLnRpbWVj
b3VudGVyLmhhcmR3YXJlPVRTQwogIDwvc2NyZWVuPgogICAgPC9wYXJhPgogIAo=
--e89a8ff2501486314f04c42fad23
Content-Type: application/octet-stream;
	name="pgtesttiming_output_Option1.diff"
Content-Disposition: attachment; filename="pgtesttiming_output_Option1.diff"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_h4br8bpd3

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9wZ3Rlc3R0aW1pbmcuc2dtbCBiL2RvYy9zcmMvc2dt
bC9wZ3Rlc3R0aW1pbmcuc2dtbApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCBmNzRkNjNlLi4x
M2JhZjY3CioqKiBhL2RvYy9zcmMvc2dtbC9wZ3Rlc3R0aW1pbmcuc2dtbAotLS0gYi9kb2Mvc3Jj
L3NnbWwvcGd0ZXN0dGltaW5nLnNnbWwKKioqKioqKioqKioqKioqIEhpc3RvZ3JhbSBvZiB0aW1p
bmcgZHVyYXRpb25zOgoqKiogMTgzLDE5MCAqKioqCiAgICAgaW5mb3JtYXRpb24gYWJvdXQgdGhl
IHRpbWVyIHNlbGVjdGVkIGR1cmluZyBib290OgogIAogIDxzY3JlZW4+CiEgZG1lc2cgfCBncmVw
ICJUaW1lY291bnRlciIKISBzeXNjdGwga2Vybi50aW1lY291bnRlci5oYXJkd2FyZT1UU0MKICA8
L3NjcmVlbj4KICAgIDwvcGFyYT4KICAKLS0tIDE4MywxOTUgLS0tLQogICAgIGluZm9ybWF0aW9u
IGFib3V0IHRoZSB0aW1lciBzZWxlY3RlZCBkdXJpbmcgYm9vdDoKICAKICA8c2NyZWVuPgohICMg
ZG1lc2cgfCBncmVwICJUaW1lY291bnRlciIKISBUaW1lY291bnRlciAiQUNQSS1mYXN0IiBmcmVx
dWVuY3kgMzU3OTU0NSBIeiBxdWFsaXR5IDkwMAohIFRpbWVjb3VudGVyICJpODI1NCIgZnJlcXVl
bmN5IDExOTMxODIgSHogcXVhbGl0eSAwCiEgVGltZWNvdW50ZXJzIHRpY2sgZXZlcnkgMTAuMDAw
IG1zZWMKISBUaW1lY291bnRlciAiVFNDIiBmcmVxdWVuY3kgMjUzMTc4NzEzNCBIeiBxdWFsaXR5
IDgwMAohICMgc3lzY3RsIGtlcm4udGltZWNvdW50ZXIuaGFyZHdhcmU9VFNDCiEga2Vybi50aW1l
Y291bnRlci5oYXJkd2FyZTogQUNQSS1mYXN0IC0+IFRTQwogIDwvc2NyZWVuPgogICAgPC9wYXJh
PgogIAo=
--e89a8ff2501486314f04c42fad23--