From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: From: Roland Hieber Date: Fri, 14 Jul 2017 12:57:15 +0200 Message-Id: <20170714105715.27051-4-r.hieber@pengutronix.de> In-Reply-To: <20170714105715.27051-1-r.hieber@pengutronix.de> References: <20170714105715.27051-1-r.hieber@pengutronix.de> MIME-Version: 1.0 Subject: [ptxdist] [PATCH 4/4] doc: faq: copy editing, small rewrites for more clarity List-Id: PTXdist Development Mailing List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: ptxdist@pengutronix.de Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: ptxdist-bounces@pengutronix.de Sender: "ptxdist" To: ptxdist@pengutronix.de Cc: Roland Hieber U2lnbmVkLW9mZi1ieTogUm9sYW5kIEhpZWJlciA8ci5oaWViZXJAcGVuZ3V0cm9uaXguZGU+Ci0t LQogZG9jL2ZhcS5yc3QgfCA2OSArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCiAxIGZpbGUgY2hhbmdlZCwgMzcgaW5zZXJ0aW9ucygr KSwgMzIgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL2ZhcS5yc3QgYi9kb2MvZmFxLnJz dAppbmRleCAyZWJiYmExN2MuLmUxOTRkZDkxNCAxMDA2NDQKLS0tIGEvZG9jL2ZhcS5yc3QKKysr IGIvZG9jL2ZhcS5yc3QKQEAgLTYsMTIgKzYsMTUgQEAgUFRYZGlzdCBkb2VzIG5vdCBzdXBwb3J0 IHRvIGdlbmVyYXRlIHNvbWUgZmlsZXMgaW4gYSB3YXkgSSBuZWVkIHRoZW0uIFdoYXQgY2FuIEkK IEFuc3dlcjoKICAgRXZlcnl0aGluZyBQVFhkaXN0IGJ1aWxkcyBpcyBjb250cm9sbGVkIGJ5IOKA nHBhY2thZ2UgcnVsZSBmaWxlc+KAnSwKICAgd2hpY2ggaW4gZmFjdCBhcmUgTWFrZWZpbGVzIChg YHJ1bGVzLyoubWFrZWBgKS4gSWYgeW91IG1vZGlmeSBzdWNoIGEKLSAgZmlsZSB5b3UgY2FuIGNo YW5nZSBpdOKAmXMgYmVoYXZpb3VyIGluIGEgd2F5IHlvdSBuZWVkLiBJdCBpcyBnZW5lcmFsbHkK LSAgbm8gZ29vZCBpZGVhIHRvIG1vZGlmeSB0aGUgZ2VuZXJpYyBwYWNrYWdlIHJ1bGUgZmlsZXMg aW5zdGFsbGVkIGJ5CisgIGZpbGUgeW91IGNhbiBjaGFuZ2UgaXRzIGJlaGF2aW91ciBpbiBhIHdh eSB5b3UgbmVlZC4gSXQgaXMgZ2VuZXJhbGx5CisgIG5vdCBhIGdvb2QgaWRlYSB0byBtb2RpZnkg dGhlIGdlbmVyaWMgcGFja2FnZSBydWxlIGZpbGVzIGluc3RhbGxlZCBieQogICBQVFhkaXN0LCBi dXQgaXQgaXMgYWx3YXlzIHBvc3NpYmxlIHRvIGNvcHkgb25lIG9mIHRoZW0gb3ZlciBpbnRvIHRo ZQotICBgYHJ1bGVzL2BgIGRpcmVjdG9yeSBvZiBhIHByb2plY3QuIFBhY2thZ2UgcnVsZSBmaWxl cyBpbiB0aGUgcHJvamVjdAorICBgYHJ1bGVzL2BgIGRpcmVjdG9yeSBvZiB5b3VyIHByb2plY3Qu IFBhY2thZ2UgcnVsZSBmaWxlcyBpbiB0aGUgcHJvamVjdAogICB3aWxsIHByZWNlZGUgZ2xvYmFs IHJ1bGUgZmlsZXMgd2l0aCB0aGUgc2FtZSBuYW1lLgogCisgIFJlYWQgdGhlIHNlY3Rpb24gOnJl ZjpgX3B0eF9kZXZfbWFudWFsYCBpbiB0aGUgRGV2ZWxvcGVy4oCZcyBNYW51YWwgdG8gZ2V0Cisg IG1vcmUgaW5mb3JtYXRpb24uCisKIEhvdyBjYW4gSSBzdG9wIFBUWGRpc3QgdG8gYnVpbGQgaW4g cGFyYWxsZWw/CiB+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fgog UXVlc3Rpb246CkBAIC0zNiwxNiArMzksMTYgQEAgUXVlc3Rpb246CiBBbnN3ZXI6CiAgIFllcywg dGhpcyBlcnJvciBtZXNzYWdlIGlzIGNvbmZ1c2luZy4gQnV0IGl0IHVzdWFsbHkgb25seSBtZWFu cwogICB0aGF0IHlvdSBzaG91bGQgY2hlY2sgdGhlIGZvbGxvd2luZyAoISkgbGluZXMgZm9yIG1p c3NpbmcgYmFja3NsYXNoZXMKLSAgKGxpbmUgc2VwYXJhdG9ycykuCisgIChsaW5lIGNvbnRpbnVh dGlvbikuCiAKIEkgZ290IGEgbWVzc2FnZSBzaW1pbGFyIHRvIOKAnHBhY2thZ2UgPG5hbWU+IGlz IGVtcHR5LiBub3QgZ2VuZXJhdGluZy7igJ0gV2hhdCBkb2VzIGl0IG1lYW4/CiB+fn5+fn5+fn5+ fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fn5+fn5+fn5+fn5+fn5+fn5+CiBBbnN3ZXI6Ci0gIFRoZSDigJlpcGtn4oCZIHRvb2wgd2Fz IGFkdmlzZWQgdG8gZ2VuZXJhdGUgYSBuZXcgaXBrZy1wYWNrZXQsIGJ1dCB0aGUKLSAgZm9sZGVy IHdhcyBlbXB0eS4gU29tZXRpbWUgaXQgbWVhbnMgYSB0eXBvIGluIHRoZSBwYWNrYWdlIG5hbWUg d2hlbgorICBUaGUgYGBpcGtnYGAgdG9vbCB3YXMgYWR2aXNlZCB0byBnZW5lcmF0ZSBhIG5ldyBp cGtnIGFyY2hpdmUsIGJ1dCB0aGUKKyAgZm9sZGVyIHdhcyBlbXB0eS4gU29tZXRpbWVzIHRoaXMg aXMganVzdCBhIHR5cG8gaW4gdGhlIHBhY2thZ2UgbmFtZSB3aGVuCiAgIHRoZSBgYGluc3RhbGxf Y29weWBgIG1hY3JvIHdhcyBjYWxsZWQuIEVuc3VyZSBhbGwgdGhlc2UgbWFjcm9zIGFyZSB1c2lu ZwotICB0aGUgc2FtZSBwYWNrYWdlIG5hbWUuIE9yIGRpZCB5b3UgZGlzYWJsZSBhIG1lbnVlbnRy eSBhbmQgbm93IG5vdGhpbmcKLSAgd2lsbCBiZSBpbnN0YWxsZWQ/CisgIHRoZSBzYW1lIHBhY2th Z2UgbmFtZS4gT3IgZGlkIHlvdSBkaXNhYmxlIGEgbWVudSBlbnRyeSBhbmQgbm93IG5vdGhpbmcK KyAgaXMgaW5zdGFsbGVkPwogCiBIb3cgZG8gSSBkb3dubG9hZCBhbGwgcmVxdWlyZWQgcGFja2Fn ZXMgYXQgb25jZT8KIH5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fgpAQCAtNTUsOCArNTgsOCBAQCBBbnN3ZXI6CiAgICAgICAkIHB0eGRpc3QgbWFrZSBnZXQK IAogICBUaGlzIHN0YXJ0cyB0byBkb3dubG9hZCBhbGwgcmVxdWlyZWQgcGFja2FnZXMgaW4gb25l IHJ1bi4gSXQgZG9lcwotICBub3RoaW5nIGlmIHRoZSBhcmNoaXZlcyBhcmUgYWxyZWFkeSBwcmVz ZW50IGluIHRoZSBzb3VyY2UgcGF0aC4gKHJ1bgotICDigJxQVFhkaXN0IHNldHVw4oCdIGZpcnN0 KS4KKyAgbm90aGluZyBpZiB0aGUgYXJjaGl2ZXMgYXJlIGFscmVhZHkgcHJlc2VudCBpbiB0aGUg c291cmNlIHBhdGguIFJ1bgorICBgYHB0eGRpc3Qgc2V0dXBgYCBmaXJzdCB0byBzZXQgdXAgdGhl IGRlc2lyZWQgc291cmNlIGZvbGRlci4KIAogSSB3YW50IHRvIGJhY2t1cCBhbGwgc291cmNlIGFy Y2hpdmVzIGZvciBteSBCU1AKIH5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fn5+fn5+CkBAIC03MSw3ICs3NCw3IEBAIEFuc3dlcjoKICAgICAgICQgcHR4ZGlzdCBleHBv cnRfc3JjIDxhcmNoaXZlIGRpcmVjdG9yeT4KIAogICBJdCBjb3BpZXMgYWxsIGFyY2hpdmVzIGZy b20gd2hlcmUgYXJlIHlvdXIgc291cmNlIGFyY2hpdmVzIHN0b3JlZCB0bwotICA8YXJjaGl2ZSBk aXJlY3Rvcnk+IHdoaWNoIGNhbiBiZSB5b3VyIGJhY2t1cCBtZWRpYS4KKyAgdGhlIHBhdGggYGA8 YXJjaGl2ZSBkaXJlY3Rvcnk+YGAgd2hpY2ggY2FuIGJlIG9uIHlvdXIgYmFja3VwIG1lZGlhLgog CiBPU0VMQVMgdG9vbGNoYWluIGZhaWxzIHRvIHN0YXJ0IGR1ZSB0byBtaXNzaW5nIGxpYnJhcmll cwogfn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn4KQEAgLTgyLDEyICs4NSwxNCBAQCBRdWVzdGlvbjoKICAgZmFpbGluZyB0byBzdGFydCBkdWUg dG8gbWlzc2luZyBsaWJyYXJpZXMuCiAKIEFuc3dlcjoKLSAgVGhpcyBoYXBwZW5zIHdoZW4gdGhl IHRvb2xjaGFpbiB3YXMgY29waWVkIHdpdGhvdXQgcmVnYXJkaW5nIHRvCi0gIHJldGFpbiBsaW5r cy4gVGhlcmUgYXJlIGFyY2hpdmUgcHJvZ3JhbXMgYXJvdW5kIHRoYXQgY29udmVydCBsaW5rcwor ICBUaGlzIGhhcHBlbnMgd2hlbiB0aGUgdG9vbGNoYWluIHdhcyBjb3BpZWQgd2l0aG91dCByZWdh cmQgdG8KKyAgcmV0YWluaW5nIHN5bWxpbmtzLiBUaGVyZSBhcmUgYXJjaGl2ZSBwcm9ncmFtcyBh cm91bmQgdGhhdCBjb252ZXJ0IGxpbmtzCiAgIGludG8gcmVhbCBmaWxlcy4gV2hlbiB5b3UgYXJl IHVzaW5nIHN1Y2ggcHJvZ3JhbXMgdG8gY3JlYXRlIGEKICAgdG9vbGNoYWluIGFyY2hpdmUgdGhp cyB0b29sY2hhaW4gd2lsbCBiZSBicm9rZW4gYWZ0ZXIgZXh0cmFjdGluZyBpdAotICBhZ2Fpbi4g U29sdXRpb246IFVzZSBhcmNoaXZlIHByb2dyYW1zIHRoYXQgcmV0YWluIGxpbmtzIGFzIHRoZXkg YXJlCi0gICh0YXIgZm9yIGV4YW1wbGUpLiBIZXJlIGFuIGV4YW1wbGUgZm9yIGEgYnJva2VuIHRv b2xjaGFpbjo6CisgIGFnYWluLgorICAKKyAgU29sdXRpb246IFVzZSBhcmNoaXZlIHByb2dyYW1z IHRoYXQgcmV0YWluIHN5bWxpbmtzIGFzIHRoZXkgYXJlCisgICh0YXIgZm9yIGV4YW1wbGUpLiBI ZXJlIGlzIGFuIGV4YW1wbGUgb2YgYSBicm9rZW4gdG9vbGNoYWluOjoKIAogICAgICAgJCBsbCBg ZmluZCAuIC1uYW1lICJsaWJjcnlwdCoiYAogICAgICAgLXJ3eHIteHIteCAxIG1rbCBwdHggNTVL IDIwMDctMDctMjUgMTQ6NTQgLi9saWIvbGliY3J5cHQtMi41LnNvKgpAQCAtMTMwLDI3ICsxMzUs MjcgQEAgVXNpbmcgbW9yZSB0aGFuIG9uZSBrZXJuZWwgdmVyc2lvbiBwZXIgQlNQCiB+fn5+fn5+ fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn4KIFF1ZXN0aW9uOgogICBJIHdhbnQg dG8gdXNlIG1vcmUgdGhhbiBvbmUga2VybmVsIHJldmlzaW9uIGluIG15IEJTUC4gSG93IGNhbiBJ Ci0gIGF2b2lkIG1haW50YWluaW5nIG9uZSBwdHhjb25maWcgcGVyIGtlcm5lbD8KKyAgYXZvaWQg bWFpbnRhaW5pbmcgb25lIHBsYXRmb3JtY29uZmlnIHBlciBrZXJuZWw/CiAKIEFuc3dlcjoKICAg T25lIHNvbHV0aW9uIGNvdWxkIGJlIHRvIGluY2x1ZGUgdGhlIGtlcm5lbCByZXZpc2lvbiBpbnRv IHRoZSBuYW1lCi0gIG9mIHRoZSBrZXJuZWwgY29uZmlnIGZpbGUuIEluc3RlYWQgb2YgdGhlIGRl ZmF1bHQga2VybmVsY29uZmlnLnRhcmdldAotICBuYW1lIHlvdSBzaG91bGQgdXNlIGBga2VybmVs Y29uZmlnLTxyZXZpc2lvbj4udGFyZ2V0YGAuIEluIHRoZSBrZXJuZWwKLSAgY29uZmlnIGZpbGUg bWVudSBlbnRyeSB5b3Ugc2hvdWxkIGVudGVyCi0gIGBga2VybmVsY29uZmlnLSRQVFhDT05GX0tF Uk5FTF9WRVJTSU9OLnRhcmdldGBgLiBXaGVuZXZlciB5b3UgY2hhbmdlCi0gIHRoZSBsaW51eCBr ZXJuZWwgVmVyc2lvbiBtZW51IGVudHJ5IG5vdywgdGhpcyB3aWxsIGVuc3VyZSB1c2luZyBhCi0g IGRpZmZlcmVudCBrZXJuZWwgY29uZmlnIGZpbGUsIHRvby4KKyAgb2YgdGhlIGtlcm5lbCBjb25m aWcgZmlsZS4gSW5zdGVhZCBvZiB0aGUgZGVmYXVsdCBgYGtlcm5lbGNvbmZpZ2BgCisgIG5hbWUg eW91IGNvdWxkIHVzZSBgYGtlcm5lbGNvbmZpZy08cmV2aXNpb24+YGAgaW5zdGVhZC4gSW4gYGBw dHhkaXN0CisgIG1lbnVjb25maWcgcGxhdGZvcm1gYCB1bmRlciAqTGludXgga2VybmVsIOKGkiBw YXRjaGluZyAmIGNvbmZpZ3VyYXRpb24qLAorICBjaGFuZ2UgdGhlIGVudHJ5ICprZXJuZWwgY29u ZmlnIGZpbGUqIHRvIHNvbWV0aGluZyBsaWtlCisgIGBga2VybmVsY29uZmlnLSRQVFhDT05GX0tF Uk5FTF9WRVJTSU9OYGAuCiAKIFVzaW5nIEphdmEgcGFja2FnZXMKIH5+fn5+fn5+fn5+fn5+fn5+ fn4KIFF1ZXN0aW9uOgotICBJ4oCZbSB0cnlpbmcgdG8gdXNlIGEgSkFWQSBiYXNlZCBwYWNrYWdl IGluIFBUWGRpc3QuIEJ1dCBjb21waWxpbmcKKyAgSeKAmW0gdHJ5aW5nIHRvIHVzZSBhIEphdmEg YmFzZWQgcGFja2FnZSBpbiBQVFhkaXN0LiBCdXQgY29tcGlsaW5nCiAgIGZhaWxzIGJhZGx5LiBE b2VzIGl0IGV2ZXIgd29yayBhdCBQZW5ndXRyb25peD8KIAogQW5zd2VyOgotICBUaGlzIGtpbmQg b2YgcGFja2FnZXMgb25seSBidWlsZCBjb3JyZWN0bHkgd2hlbiBhbiBvcmlnaW5hbCBTVU4gVk0K LSAgU0RLIGlzIHVzZWQuIFJ1biBQVFhkaXN0IHNldHVwIGFuZCBwb2ludCB0aGUgSmF2YSBTREsg bWVudSBlbnRyeSB0bwotICB0aGUgaW5zdGFsbGF0aW9uIHBhdGggb2YgeW91ciBTVU4gSkFWQSBT REsuCisgIFNvbWUgSmF2YSBwYWNrYWdlcyBvbmx5IGJ1aWxkIGNvcnJlY3RseSB3aGVuIGFuIG9y aWdpbmFsIE9yYWNsZSBKYXZhCisgIFNESyBpcyB1c2VkIG9uIHRoZSBob3N0LgorICBSdW4gYGBw dHhkaXN0IHNldHVwYGAgYW5kIHBvaW50IHRoZSAqSmF2YSBTREsqIG1lbnUgZW50cnkgdG8KKyAg dGhlIGluc3RhbGxhdGlvbiBwYXRoIG9mIHlvdXIgT3JhY2xlIEphdmEgU0RLLgogCiBJIGdldCB0 aGUgZXJyb3Ig4oCcY2Fubm90IHJ1biAnL2V0Yy9pbml0LmQvcmNTJzogTm8gc3VjaCBmaWxlIG9y IGRpcmVjdG9yeeKAnQogfn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fgpAQCAtMTY4LDIyICsxNzMsMjIgQEAgQW5z d2VyOgogSSBnZXQgdGhlIGVycm9yIOKAnHB0eGRpc3Q6IGFyY2hpdmVzOiBjb21tYW5kIG5vdCBm b3VuZOKAnQogfn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fn5+CiBRdWVzdGlvbjoKLSAgSSBoYXZlIGNyZWF0ZWQgYSBwYXRoIGZvciBteSBzb3VyY2Ug YXJjaGl2ZXMgYW5kIHRyeSB0byBtYWtlIFBUWGRpc3QKLSAgdXNlIGl0LiBCdXQgd2hlbmV2ZXIg SSBydW4gUFRYZGlzdCBub3cgaXQgZmFpbHMgd2l0aCB0aGUgZm9sbG93aW5nIGVycm9yCisgIEkg aGF2ZSBzZXQgYSBwYXRoIGZvciBteSBzb3VyY2UgYXJjaGl2ZXMgaW4gYGBwdHhkaXN0IHNldHVw YGAuCisgIEJ1dCB3aGVuZXZlciBJIHJ1biBQVFhkaXN0IG5vdyBpdCBmYWlscyB3aXRoIHRoZSBm b2xsb3dpbmcgZXJyb3IKICAgbWVzc2FnZTo6CiAKICAgICAgIC91c3IvbG9jYWwvYmluL3B0eGRp c3Q6IGFyY2hpdmVzOiBjb21tYW5kIG5vdCBmb3VuZAogCiBBbnN3ZXI6Ci0gIEluIHRoaXMgY2Fz ZSB0aGUgcGF0aCB3YXMgYGAkSE9NRS9zb3VyY2UgYXJjaGl2ZXNgYCB3aGljaCBpbmNsdWRlcyBh Ci0gIHdoaXRlc3BhY2UgaW4gdGhlIG5hbWUgb2YgdGhlIGRpcmVjdG9yeSB0byBzdG9yZSB0aGUg c291cmNlIGFyY2hpdmVzIGluLgorICBUaGlzIGhhcHBlbnMgaWYgeW91ciBzb3VyY2UgZG93bmxv YWQgcGF0aCBjb250YWlucyB3aGl0ZXNwYWNlLCBlLmcKKyAgYGAkSE9NRS9zb3VyY2UgYXJjaGl2 ZXNgYC4KICAgSGFuZGxpbmcgZGlyZWN0b3J5IG9yIGZpbGVuYW1lcyB3aXRoIHdoaXRlc3BhY2Vz IGluIGFwcGxpY2F0aW9ucyBpc27igJl0CiAgIHRyaXZpYWwgYW5kIGFsc28gUFRYZGlzdCBzdWZm ZXJzIGFsbCBvdmVyIHRoZSBwbGFjZSBmcm9tIHRoaXMgaXNzdWUuIFRoZQotICBvbmx5IHNvbHV0 aW9uIGlzIHRvIGF2b2lkIHdoaXRlc3BhY2VzIGluIHBhdGhzIGFuZCBmaWxlbmFtZXMuCisgIG9u bHkgc29sdXRpb24gaXMgdG8gYXZvaWQgd2hpdGVzcGFjZSBpbiBwYXRocyBhbmQgZmlsZW5hbWVz LgogCiBJIGhhdmUgYWRhcHRlZCBteSBvd24gcnVsZSBmaWxl4oCZcyB0YXJnZXRpbnN0YWxsIHN0 YWdlLCBidXQgUFRYZGlzdCBkb2VzIG5vdCBpbnN0YWxsIHRoZSBmaWxlcwogfn5+fn5+fn5+fn5+ fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+CiBBbnN3ZXI6CiAgIENoZWNrIGlmIHRoZSBjbG9zaW5n IGBgQCQoY2FsbCBpbnN0YWxsX2ZpbmlzaCwgWy4uLl0pYGAgaXMgcHJlc2VudCBhdAotICB0aGUg ZW5kIG9mIHRoZSB0YXJnZXRpbnNhbGwgc3RhZ2UuICBJZiBub3QsIFBUWGRpc3Qgd2lsbCBub3Qg Y29tcGxldGUKKyAgdGhlIGVuZCBvZiB0aGUgKnRhcmdldGluc3RhbGwqIHN0YWdlLiBJZiBub3Qs IFBUWGRpc3Qgd2lsbCBub3QgY29tcGxldGUKICAgdGhpcyBzdGFnZS4KLS0gCjIuMTEuMAoKCl9f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCnB0eGRpc3QgbWFp bGluZyBsaXN0CnB0eGRpc3RAcGVuZ3V0cm9uaXguZGU=