From owner-freebsd-doc@FreeBSD.ORG Mon Jul 2 23:08:00 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6438F106566B for ; Mon, 2 Jul 2012 23:08:00 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 1F2258FC08 for ; Mon, 2 Jul 2012 23:08:00 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q62N7xUX007235 for ; Mon, 2 Jul 2012 17:07:59 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q62N7xob007232 for ; Mon, 2 Jul 2012 17:07:59 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 2 Jul 2012 17:07:59 -0600 (MDT) From: Warren Block To: doc@freebsd.org Message-ID: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="-902635197-1690239172-1341270479=:7110" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Mon, 02 Jul 2012 17:07:59 -0600 (MDT) Cc: Subject: Handbook update: HorizSync and VertRefresh X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jul 2012 23:08:00 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---902635197-1690239172-1341270479=:7110 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII The X11 configuration chapter of the Handbook has some very old information which is confusing users. Manually setting HorizSync and VertRefresh has been mostly useless for many years, and should be deemphasized. This patch does that. Instead of saying the sync frequencies must always be entered, it adds some information about autodetection and points out that almost all monitors support it. Also added is a note not to guess about sync frequencies. On the CRT monitors where it matters, it can matter a lot. Some of those monitors might still be functional. Feedback welcome. If there aren't any loud screams of outrage, squawks of offense, or mere bacaws of disgust, I'll commit it in a couple of days. ---902635197-1690239172-1341270479=:7110 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=patch-handbook-sync.diff Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Content-Disposition: attachment; filename=patch-handbook-sync.diff SW5kZXg6IGRvYy9lbl9VUy5JU084ODU5LTEvYm9va3MvaGFuZGJvb2sveDEx L2NoYXB0ZXIuc2dtbA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLS0tIGRv Yy9lbl9VUy5JU084ODU5LTEvYm9va3MvaGFuZGJvb2sveDExL2NoYXB0ZXIu c2dtbAkocmV2aXNpb24gMzkxNjcpDQorKysgZG9jL2VuX1VTLklTTzg4NTkt MS9ib29rcy9oYW5kYm9vay94MTEvY2hhcHRlci5zZ21sCSh3b3JraW5nIGNv cHkpDQpAQCAtMzY0LDM2ICszNjQsNDcgQEANCiAgICAgPHNlY3QyPg0KICAg ICAgIDx0aXRsZT5CZWZvcmUgU3RhcnRpbmc8L3RpdGxlPg0KIA0KLSAgICAg IDxwYXJhPkJlZm9yZSBjb25maWd1cmF0aW9uIG9mIFgxMQ0KLQl0aGUgZm9s bG93aW5nIGluZm9ybWF0aW9uIGFib3V0IHRoZSB0YXJnZXQgc3lzdGVtIGlz IG5lZWRlZDo8L3BhcmE+DQorICAgICAgPHBhcmE+SW4gbW9zdCBjYXNlcywg WDExIGlzIHNlbGYtY29uZmlndXJpbmcuICBUaG9zZSB3aXRoIG9sZGVyDQor CW9yIHVudXN1YWwgZXF1aXBtZW50IG1heSBmaW5kIGl0IGhlbHBmdWwgdG8g Z2F0aGVyIHNvbWUNCisJaGFyZHdhcmUgaW5mb3JtYXRpb24gYmVmb3JlIGJl Z2lubmluZyBjb25maWd1cmF0aW9uLjwvcGFyYT4NCiANCiAgICAgICA8aXRl bWl6ZWRsaXN0Pg0KLQk8bGlzdGl0ZW0+PHBhcmE+TW9uaXRvciBzcGVjaWZp Y2F0aW9uczwvcGFyYT48L2xpc3RpdGVtPg0KLQk8bGlzdGl0ZW0+PHBhcmE+ VmlkZW8gQWRhcHRlciBjaGlwc2V0PC9wYXJhPjwvbGlzdGl0ZW0+DQotCTxs aXN0aXRlbT48cGFyYT5WaWRlbyBBZGFwdGVyIG1lbW9yeTwvcGFyYT48L2xp c3RpdGVtPg0KKwk8bGlzdGl0ZW0+PHBhcmE+TW9uaXRvciBzeW5jIGZyZXF1 ZW5jaWVzPC9wYXJhPjwvbGlzdGl0ZW0+DQorCTxsaXN0aXRlbT48cGFyYT5W aWRlbyBjYXJkIGNoaXBzZXQ8L3BhcmE+PC9saXN0aXRlbT4NCisJPGxpc3Rp dGVtPjxwYXJhPlZpZGVvIGNhcmQgbWVtb3J5PC9wYXJhPjwvbGlzdGl0ZW0+ DQogICAgICAgPC9pdGVtaXplZGxpc3Q+DQogDQotICAgICAgPGluZGV4dGVy bT48cHJpbWFyeT5ob3Jpem9udGFsIHNjYW4gcmF0ZTwvcHJpbWFyeT48L2lu ZGV4dGVybT4NCi0gICAgICA8aW5kZXh0ZXJtPjxwcmltYXJ5PnZlcnRpY2Fs IHNjYW4gcmF0ZTwvcHJpbWFyeT48L2luZGV4dGVybT4NCisgICAgICA8aW5k ZXh0ZXJtPg0KKwk8cHJpbWFyeT5ob3Jpem9udGFsIHN5bmMgZnJlcXVlbmN5 PC9wcmltYXJ5Pg0KKyAgICAgIDwvaW5kZXh0ZXJtPg0KKyAgICAgIDxpbmRl eHRlcm0+DQorCTxwcmltYXJ5Pmhvcml6b250YWwgc2NhbiByYXRlPC9wcmlt YXJ5Pg0KKwk8c2VlPmhvcml6b250YWwgc3luYyBmcmVxdWVuY3k8L3NlZT4N CisgICAgICA8L2luZGV4dGVybT4NCisgICAgICA8aW5kZXh0ZXJtPjxwcmlt YXJ5PnJlZnJlc2ggcmF0ZTwvcHJpbWFyeT48L2luZGV4dGVybT4NCisgICAg ICA8aW5kZXh0ZXJtPg0KKwk8cHJpbWFyeT52ZXJ0aWNhbCBzeW5jIGZyZXF1 ZW5jeTwvcHJpbWFyeT4NCisJPHNlZT5yZWZyZXNoIHJhdGU8L3NlZT4NCisg ICAgICA8L2luZGV4dGVybT4NCisgICAgICA8aW5kZXh0ZXJtPg0KKwk8cHJp bWFyeT52ZXJ0aWNhbCBzY2FuIHJhdGU8L3ByaW1hcnk+DQorCTxzZWU+cmVm cmVzaCByYXRlPC9zZWU+DQorICAgICAgPC9pbmRleHRlcm0+DQogDQotICAg ICAgPHBhcmE+VGhlIHNwZWNpZmljYXRpb25zIGZvciB0aGUgbW9uaXRvciBh cmUgdXNlZCBieQ0KLQlYMTEgdG8gZGV0ZXJtaW5lIHRoZSByZXNvbHV0aW9u IGFuZA0KLQlyZWZyZXNoIHJhdGUgdG8gcnVuIGF0LiAgVGhlc2Ugc3BlY2lm aWNhdGlvbnMgY2FuIHVzdWFsbHkgYmUNCi0Jb2J0YWluZWQgZnJvbSB0aGUg ZG9jdW1lbnRhdGlvbiB0aGF0IGNhbWUgd2l0aCB0aGUgbW9uaXRvciBvciBm cm9tDQotCXRoZSBtYW51ZmFjdHVyZXIncyB3ZWJzaXRlLiAgVGhlcmUgYXJl IHR3byByYW5nZXMgb2YgbnVtYmVycyB0aGF0DQotCWFyZSBuZWVkZWQsIHRo ZSBob3Jpem9udGFsIHNjYW4gcmF0ZSBhbmQgdGhlIHZlcnRpY2FsIHN5bmNo cm9uaXphdGlvbg0KLQlyYXRlLjwvcGFyYT4NCisgICAgICA8cGFyYT5TY3Jl ZW4gcmVzb2x1dGlvbiBhbmQgcmVmcmVzaCByYXRlIGFyZSBkZXRlcm1pbmVk IGJ5IHRoZQ0KKwltb25pdG9yJ3MgaG9yaXpvbnRhbCBzeW5jIGFuZCB2ZXJ0 aWNhbCBzeW5jIGZyZXF1ZW5jaWVzLg0KKwlBbG1vc3QgYWxsIG1vbml0b3Jz IHN1cHBvcnQgYXV0b2RldGVjdGlvbiBvZiB0aGVzZSB2YWx1ZXMNCisJZWxl Y3Ryb25pY2FsbHkuICBBIGZldyBtb25pdG9ycyBkbyBub3QgcHJvdmlkZSB0 aGVzZSB2YWx1ZXMsDQorCWFuZCB0aGUgc3BlY2lmaWNhdGlvbnMgbXVzdCBi ZSBkZXRlcm1pbmVkIGZyb20gdGhlIHByaW50ZWQNCisJZG9jdW1lbnRhdGlv biBvciBtYW51ZmFjdHVyZXIgd2ViIHNpdGUuPC9wYXJhPg0KIA0KLSAgICAg IDxwYXJhPlRoZSB2aWRlbyBhZGFwdGVyJ3MgY2hpcHNldCBkZWZpbmVzIHdo YXQgZHJpdmVyIG1vZHVsZQ0KLQlYMTEgdXNlcyB0byB0YWxrIHRvIHRoZSBn cmFwaGljcw0KLQloYXJkd2FyZS4gIFdpdGggbW9zdCBjaGlwc2V0cywgdGhp cyBjYW4gYmUgYXV0b21hdGljYWxseQ0KLQlkZXRlcm1pbmVkLCBidXQgaXQg aXMgc3RpbGwgdXNlZnVsIHRvIGtub3cgaW4gY2FzZSB0aGUgYXV0b21hdGlj DQotCWRldGVjdGlvbiBkb2VzIG5vdCB3b3JrIGNvcnJlY3RseS48L3BhcmE+ DQorICAgICAgPHBhcmE+VGhlIHZpZGVvIGNhcmQncyBjaGlwc2V0IGlzIGFs c28gYXV0b2RldGVjdGVkLCBhbmQgdXNlZA0KKwl0byBzZWxlY3QgdGhlIHBy b3BlciB2aWRlbyBkcml2ZXIuICBJdCBpcyBiZW5lZmljaWFsIGZvciB0aGUN CisJdXNlciB0byBiZSBhd2FyZSBvZiB3aGljaCBjaGlwc2V0IGlzIGluc3Rh bGxlZCBmb3Igd2hlbg0KKwlhdXRvZGV0ZWN0aW9uIGRvZXMgbm90IHByb3Zp ZGUgdGhlIGRlc2lyZWQgcmVzdWx0LjwvcGFyYT4NCiANCi0gICAgICA8cGFy YT5WaWRlbyBtZW1vcnkgb24gdGhlIGdyYXBoaWMgYWRhcHRlciBkZXRlcm1p bmVzIHRoZQ0KLQlyZXNvbHV0aW9uIGFuZCBjb2xvciBkZXB0aCB3aGljaCB0 aGUgc3lzdGVtIGNhbiBydW4gYXQuICBUaGlzIGlzDQotCWltcG9ydGFudCB0 byBrbm93IHNvIHRoZSB1c2VyIGtub3dzIHRoZSBsaW1pdGF0aW9ucyBvZiB0 aGUNCi0Jc3lzdGVtLjwvcGFyYT4NCisgICAgICA8cGFyYT5NZW1vcnkgYXZh aWxhYmxlIG9uIHRoZSB2aWRlbyBjYXJkIGRldGVybWluZXMgdGhlIG1heGlt dW0NCisJcmVzb2x1dGlvbiBhbmQgY29sb3IgZGVwdGggd2hpY2ggY2FuIGJl IGRpc3BsYXllZC48L3BhcmE+DQogICAgIDwvc2VjdDI+DQogDQogICAgIDxz ZWN0Mj4NCkBAIC01ODQsMTIgKzU5NSwxMiBAQA0KIA0KICAgICAgIDxpbmRl eHRlcm0+PHByaW1hcnk+WDExIHR1bmluZzwvcHJpbWFyeT48L2luZGV4dGVy bT4NCiANCi0gICAgICA8cGFyYT5OZXh0LCB0dW5lIHRoZSA8ZmlsZW5hbWU+ eG9yZy5jb25mLm5ldzwvZmlsZW5hbWU+DQotCWNvbmZpZ3VyYXRpb24gZmls ZSB0byB0YXN0ZS4gIE9wZW4gdGhlIGZpbGUgaW4gYSB0ZXh0IGVkaXRvciBz dWNoDQotCWFzICZtYW4uZW1hY3MuMTsgb3IgJm1hbi5lZS4xOy4gIEZpcnN0 LCBhZGQgdGhlDQotCWZyZXF1ZW5jaWVzIGZvciB0aGUgdGFyZ2V0IHN5c3Rl bSdzIG1vbml0b3IuICBUaGVzZSBhcmUgdXN1YWxseQ0KLQlleHByZXNzZWQg YXMgYSBob3Jpem9udGFsIGFuZCB2ZXJ0aWNhbCBzeW5jaHJvbml6YXRpb24g cmF0ZS4gIFRoZXNlDQotCXZhbHVlcyBhcmUgYWRkZWQgdG8gdGhlIDxmaWxl bmFtZT54b3JnLmNvbmYubmV3PC9maWxlbmFtZT4gZmlsZQ0KKyAgICAgIDxw YXJhPlRoZSA8ZmlsZW5hbWU+eG9yZy5jb25mLm5ldzwvZmlsZW5hbWU+DQor CWNvbmZpZ3VyYXRpb24gZmlsZSBtYXkgbm93IGJlIHR1bmVkIHRvIHRhc3Rl LiAgT3BlbiB0aGUgZmlsZSBpbiBhIHRleHQgZWRpdG9yIHN1Y2gNCisJYXMg Jm1hbi5lbWFjcy4xOyBvciAmbWFuLmVlLjE7LiAgSWYgdGhlIG1vbml0b3Ig aXMgYW4gb2xkZXINCisJb3IgdW51c3VhbCBtb2RlbCB0aGF0IGRvZXMgbm90 IHN1cHBvcnQgYXV0b2RldGVjdGlvbiBvZg0KKwlzeW5jIGZyZXF1ZW5jaWVz LCB0aG9zZSBzZXR0aW5ncyBjYW4NCisJYmUgYWRkZWQgdG8gPGZpbGVuYW1l PnhvcmcuY29uZi5uZXc8L2ZpbGVuYW1lPg0KIAl1bmRlciB0aGUgPGxpdGVy YWw+Ik1vbml0b3IiPC9saXRlcmFsPiBzZWN0aW9uOjwvcGFyYT4NCiANCiAg ICAgICA8cHJvZ3JhbWxpc3Rpbmc+U2VjdGlvbiAiTW9uaXRvciINCkBAIC02 MDAsMTQgKzYxMSwxMSBAQA0KIAlWZXJ0UmVmcmVzaCAgNDgtMTIwDQogRW5k U2VjdGlvbjwvcHJvZ3JhbWxpc3Rpbmc+DQogDQotICAgICAgPHBhcmE+VGhl IDxsaXRlcmFsPkhvcml6U3luYzwvbGl0ZXJhbD4gYW5kDQotCTxsaXRlcmFs PlZlcnRSZWZyZXNoPC9saXRlcmFsPiBrZXl3b3JkcyBtYXkgYmUgbWlzc2lu ZyBpbiB0aGUNCi0JY29uZmlndXJhdGlvbiBmaWxlLiAgSWYgdGhleSBhcmUs IHRoZXkgbmVlZCB0byBiZSBhZGRlZCwgd2l0aA0KLQl0aGUgY29ycmVjdCBo b3Jpem9udGFsIHN5bmNocm9uaXphdGlvbiByYXRlIHBsYWNlZCBhZnRlciB0 aGUNCi0JPGxpdGVyYWw+SG9yaXpTeW5jPC9saXRlcmFsPiBrZXl3b3JkIGFu ZCB0aGUgdmVydGljYWwNCi0Jc3luY2hyb25pemF0aW9uIHJhdGUgYWZ0ZXIg dGhlIDxsaXRlcmFsPlZlcnRSZWZyZXNoPC9saXRlcmFsPg0KLQlrZXl3b3Jk LiAgSW4gdGhlIGV4YW1wbGUgYWJvdmUgdGhlIHRhcmdldCBtb25pdG9yJ3Mg cmF0ZXMgd2VyZQ0KLQllbnRlcmVkLjwvcGFyYT4NCisgICAgICA8cGFyYT5N b3N0IG1vbml0b3JzIHN1cHBvcnQgc3luYyBmcmVxdWVuY3kgYXV0b2RldGVj dGlvbiwgbWFraW5nDQorCW1hbnVhbCBlbnRyeSBvZiB0aGVzZSB2YWx1ZXMg dW5uZWNlc3NhcnkuICBXaGVuIGEgbW9uaXRvciBkb2VzDQorCW5vdCBzdXBw b3J0IGF1dG9kZXRlY3Rpb24sIGl0IGlzIGltcG9ydGFudCB0byBzZXQgdGhl c2UNCisJZnJlcXVlbmNpZXMgb25seSB0byB0aGUgdmFsdWVzIHByb3ZpZGVk IGJ5IHRoZSBtYW51ZmFjdHVyZXIuDQorCURvIG5vdCBndWVzcy48L3BhcmE+ DQogDQogICAgICAgPHBhcmE+WCBhbGxvd3MgRFBNUyAoRW5lcmd5IFN0YXIp IGZlYXR1cmVzIHRvIGJlIHVzZWQgd2l0aCBjYXBhYmxlDQogCW1vbml0b3Jz LiBUaGUgJm1hbi54c2V0LjE7IHByb2dyYW0gY29udHJvbHMgdGhlIHRpbWUt b3V0cyBhbmQgY2FuIGZvcmNlDQpAQCAtNjg0LDcgKzY5Miw3IEBADQogICAg ICAgPHRpdGxlPkFkdmFuY2VkIENvbmZpZ3VyYXRpb24gVG9waWNzPC90aXRs ZT4NCiANCiAgICAgICA8c2VjdDM+DQotCTx0aXRsZT5Db25maWd1cmF0aW9u IHdpdGggJmludGVsOyBpODEwIEdyYXBoaWNzIENoaXBzZXRzPC90aXRsZT4N CisJPHRpdGxlPkNvbmZpZ3VyYXRpb24gd2l0aCAmaW50ZWw7IDxsaXRlcmFs Pmk4MTA8L2xpdGVyYWw+IEdyYXBoaWNzIENoaXBzZXRzPC90aXRsZT4NCiAN CiAJPGluZGV4dGVybT48cHJpbWFyeT5JbnRlbCBpODEwIGdyYXBoaWMgY2hp cHNldDwvcHJpbWFyeT48L2luZGV4dGVybT4NCiANCg== ---902635197-1690239172-1341270479=:7110--