diff options
Diffstat (limited to 'doc/bashref.ps')
-rw-r--r-- | doc/bashref.ps | 3887 |
1 files changed, 1962 insertions, 1925 deletions
diff --git a/doc/bashref.ps b/doc/bashref.ps index a0f9ffb6..ef713103 100644 --- a/doc/bashref.ps +++ b/doc/bashref.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 5.999 Copyright 2019 Radical Eye Software %%Title: bashref.dvi -%%CreationDate: Wed Jun 10 16:00:45 2020 +%%CreationDate: Mon Sep 7 13:52:24 2020 %%Pages: 189 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2020.06.10:1200 +%DVIPSSource: TeX output 2020.09.07:0952 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -4958,6 +4958,7 @@ dup 100 /d put dup 101 /e put dup 103 /g put dup 105 /i put +dup 107 /k put dup 108 /l put dup 109 /m put dup 110 /n put @@ -5191,108 +5192,117 @@ F435BC210621851001B6A402E3A07D0F204A3B0D75DA3CD7FF6637D1F434B962 F404DB3C6BC318EF517AA0836A975C5196976250B5D6B21DF528FB47181F5279 E1EEBBA0F344D7EABE71904B5C1DB0FD07694C469085D50DF4990E294334E785 5E5BCC4ADCD38685147CE535B23F3027AAC01A0D65AC751D9CA289B4A8906A64 -165427976FE6FD699442196B0C247C960C9086AB2E440885D2C32FFC5FC7105F -6C40A76A1968AADBBAD6F3C21FBC076F4F67DE62E1CECD38BE03720FFA886743 -846FFD2005F85371FFB9C962AE2D88586DC9DA2F98996DF8572551C3D49E1ED4 -41248FA76E07B2A5CB9C3451247F60C7AA164ED895CD6290427E828A7FB72F71 -7CC249C92A012C0FE99FC07EE7E084E190CCCB95E66A39EAFA7934598C69F04C -68B2C68DF99ADB347AB05F1905B8704A51FBF9471FB20CCD3CC87EF9FD75DDDE -125EA68997DDE4174DFA0ADA2664E7209E4EA1B460CBDFA79D033D33FA9C5075 -DB424689F927F06ADB87DF0C3F4600ADC9CDB197E41430047247E7645A0AAFFE -750AA1A154498C0B5371ADB099C1E273DE2E367DDE7ADEC2CAF9406A67585AB0 -D39F051BC556A8E569AB9EA4E69557A1DFCB8CD459403A616821AC61E35DE1E9 -2673435E5969EE48F3B9F9777E5F70C682FB7C10E6E7FAC5F5732C9EC2DEFD5F -9A28572ACC62C108861AB22894979195B88E6A08A533629295A58643F854BC9E -082F9073AC94EE08DC1CFC626DE4D341D7994178E708D4D8226897B54CC2B4DE -B37D5BEDC430404177977EEEFD7201713AC45FE927D4FBA0F2613A2FBCF890C1 -908E1DBCCD277E78E42363374E103BBD6C3DAD925A9422469648B9D8BE7391F6 -B448994EA40AF3A3EA7E6E938D0F93B9EBB4E09B5D2E8D9ABF1F4AAEE8A0A304 -EDBA6DF569ECD449FF362660B11DE8A13A71C6C8186273C7417C4572DDD8B993 -C96289B16223B271D026929B2CB9D3AB7A3511F09C6F303A7006705482E9AEF4 -FC76BC1B1FD42095857751315F5B06701E774FF08920342667E99EBBF5A19210 -9AAEDC8033E06007AA89BEFA5A1616095A8E90C999BC3EB266879EDE7D1218F1 -3CB238D180C463AAF853E315CA564247B6E029D8200B9DB7B13EAE09264A5DD1 -4A080EAEDA74C7FD21BB208FD8EBEC1D650C0AE392C67D65C1773A68F2CA313C -15FE2E4A0B6E7DA9CE391BF6D854431F0EEB550A818B6B95EFE6F72504AF5CE9 -73DC8E3326E2E57F4031688F10D1C272D41AB40B7EBA371ED357E67C31DBFDA0 -B8412EDBFBC2B6F26FD7331BC965DDFB1A4A17B72BB94338283A8D9139B9816F -D13C12E07B69E9FBD0C5FA9B1DAC2E51324695102DAAFA746D969E5F64980707 -228DA50443B2917FF685F5872D782CA265734036B7A7D75588C638AB9687D34D -D0221C0B3EB0A8DFE91598F07CE2C35E1C4E01E26D0358841EDADA02D3844B26 -C39D492C480244124F422EFE57D38DD912EC98582F05C74B4ED83BE81C363376 -B816F23D10C5C8CA831E1351F3BF914B07F638FA5712A1E05E3B751E756296C9 -2FF074FFC22CFC383804A92057155C4E43FA4990734C83257E810F3C2A62F42C -B5328A41BE80C23F49479EF84BA8D13BF3A45EC435781B9480659A4D58041190 -3DA62807723CDF1EE71EFA22BB67887DA88EB20DDC0D1A36A75C06BBA651DE67 -651BB57824E4F5264DEAA04927D2A29730B7293E08FE3FAE5FF493EDDC0F2232 -9476F3CA26707E823808329390EC9D8913AAC2D8DF2A6B5673E1A0F4E7E67C9A -D006E7DD429BCC550DF7323DAB781F82A837C83C80DDB8970CE699153576ABD7 -4BA82C753C82F19E30B853DD086DB119C48ADA56C39352E3C6B1FA232390BA3D -02482A6B845C324593FF845A572E1F026941AE3DDBFF83E8230FD5214B631EDC -69E178C52B5FB4BFF0C89B756E759147596D038850F0A468B20163093F8BADE8 -FB0F718C66D82C41A29EBEC417DE0B72C4F8E746EEEA33F2BFC0063E2514456D -6EC34CA68E1C667D47FB582C3A259AF4D0859C68AAC0E5F89CC91A1F508CE835 -E29B7860E6484F8B0D75C1635A32FDE55F119C8222A5D00D9C45930C9F5C97BE -A28EFB48BEF95ABD910E66CBC4C34AF6299A84CA55F780A013E8B3DBC4E57F2A -1EEE358D24775DEC537CEE09212EB3208E497330427706696335F03BA50BD193 -E022E668C6602731D51102FB7BBBF43A630BC428FCE711882EFE6E7739DC10BB -63B60272DE6FE4841F7728EA80F871F1648E3478DA71BF29F66FC3565AC3C632 -AEDBCCDDA048A807FCB6CC497A1CA11C6E802C1ABEC3BD80E116A648531484F1 -722E3EDA1EAF6DFF1D3CBB1759C4AEF33A300E7770B8A24F7EAD130B31A0AEF6 -26C369A8DDD409A1343BB66DB2B2F7882FD168C008D5721B3EF2DE8B56EA35D9 -2E456FCEF55927D78D20A99B96EE83A25BAD4DB679511BF4E27E552F871612C9 -6B8C2D5BAF77B648C654AE0D9E6402998E07906B58984B94987216AB9EDB2699 -E0EDFB6AD08E25F2575E1B93157F2F6A0D215ADCE1D21AFB6E4DCA3635E2D4B7 -825A4EAF8568D1A2ED4D6E8C9C6DBFC08D259001EEA83D3ED9A416435A79B56B -3F7B0AE9A5781694E22FC68152BB68409B61B9A59CC8D58CE1EA9C0DBB329554 -44E4D85F3A4BFCF8AD90771A203FEBD6EE00D118EA5833C96F1BC0CAABFE69FB -0BCC46E7A3280E16976D86722168F695FB6422734512954A97AA0BA8AF8155ED -2434100023E1FFCC504AFFEF6C2F70B1F2506E53648271DDCB82754F9775C323 -B77590E86374A9B01FD57FBDD3F3BF8D61CACB66909E6C95C81BA7B083913635 -30C7C0BB9EB7310F23D2991BC6D5CFA9A35AAD04B14CC5540A16C9BE0094A8DB -058B1DC4D5744C8F89257A04B1D8544C1405D8FA71A780E92D767A170C269668 -202ABE3126680D93532C2EB8EC3A140D604C79906C626AB0185669AF9A425CAA -465C3DD47810CBA44AD7E2BFCA99FCDA98EB641608032051AC5CC30329C28536 -F5637FC7E371BEFE11320FDB5B6530E513CB14122289CEFA88A97733E4F888D1 -23030714F61091B5ADFFE84E3505E32C347EE1D624AE666E8BC6F416F78CF6F5 -96FE5D12F574F8114C71A10596847A8BA0B03DEDB6AC72F218129B223F422908 -138A916F2605142D5EFF5F4BDA5627E59DAAE09A674B7D5BCECDD63BF5E7C119 -410A36161335A18A93891CABC830833D1FAC47B7A85BC9EA27BCE6F727E7D35B -348918F512C3BF7769C185A277BA930170AAAC6708F04F00C47251D2679DB455 -F9BB928838F148C1AFEA1C56AA779C54948B9DC0E827706834D9469825FEB644 -6AF843E71E44D0380311A3A6D9B7543A6A24B475BEB483D63BAC1B9421211570 -FF9BEA65E81FDAAF0E00A1555B0A69C8355143DA9B547BD1AED32120C58AFA09 -AC34163ACFBFE0E00D57A5ECC73E522AF84A2EE0C9655C6AE6E67BF4473CD8A7 -E7F95AB4EEB4AF83ADF597547CDE2426F200FB8824E2A826356096B962F31B98 -AB1B27FD681C1F67EC07FFEE7240F704E925E62749E2D2C7CD85C61F14B8A03A -666339793934155EB270C0C7B58AB8DF6C52B72038257BE0CDDD9B2A484DC97E -862C67F7AEE273480192980A5BCD8CCDDB87CBED18899B09B0A485FB4A1FB061 -79A918589500995F12211C3E636FD1A7F6F746A231E42C80152EE4E2C1E65FC4 -4075CD6B10A7183C711573498FC034C82A5B66EED4F921646F8A9AC989F7C655 -BC0C74049D81A3AA11FFC20CD823BBBEB6E58FED16B9AC143EF2E2981BCB5605 -71C71C8BE4112AF04B3D2D9C46F948C8E3862AAF882871C3A05CF720DB14ABBD -B0B2A5C41E35DA879B3109E31226C317CE405C2186F54D710AA503B8EC76BE1D -BABDC05B316D5382568D4938C7D462B3009A648BDC22C640CE6E891375DC26F2 -A7B36C4F4DBF909B2858AD23DB71783204AFA075488322462A92F0E6739E0A28 -486BD3BC19B3665275ABE63BA5B31936B0097A08717141505568962BBD257511 -B714C52EE8CA7A37B3C0322B7F5A5690BE2FB23AA9FB322107CA58B4CA4032BD -2026815102CD4688655FACF599739F8C10EE5890AB65B167C5FC0C8F855EF2E5 -0B3F95EDE6BED4CC277CBFD004B7D13734F605E1B929204850434638F7244B70 -176FDEDEEED09D16703108DF3041687BE3EF06ECC78CA7BD028A24676753F889 -32E2B027250023B80E514BCE566E9CAB8F8B516544EED082741972528E2D9D94 -29D8F03449066FA4412350A5549767945AF5E678BCBE884532DA8C66A612465F -4E2D1CA7353C2F7E0418E1C989026583844702D344900E05FB45FED3401FBED1 -F63830D700F1EC2F4AED4EF8D077EB9903AE3E1AEC126EF9A03AC25D5FB37CD1 -8CAD9A29B803EE39CD78AEA670E2304EFDF0B9E52537DF6BDDD44022F0C00895 -6EDCCFCCD3430853617597EFDC25E915E4F977F9910D640FB088085A96E7FB59 -3570E01A50A7D4903E01C398B5F461BF23638812C245AAE2F5DE500FD2D44E57 -336BDD4B538C081BBFDEE78D8FC75A19F204A15C2E18BBE879BEC3F675663D3B -73124D4FE6BB1AA1E6E5D6FAB878B479523CC51E4E734AA090DC70DF610CE359 -8357A2C4842AEC553871063A9127C952AC9A64FE3891CD4D0879B41CAAA2FF8B -0F4336BE27DC0C179FF91D867FAB89D05E382EC85C2DD1E1BFB4B66C6EF9AB3A -7A7FA0285EF3B67A1249BBB1493AAA17E355690753D2978D937FA5373D195D9C -9F2A3F7F6F71BB04BC47EFC7D24F11DAAFA20FEBBE5098976E8C002629C7A5D0 -4BC339B70105CEF46994F8780AB84FD47367F996418E00BE7002 +165427976FE6FD699442196B0C247C960C9086AB2E440885D11BDD314A3FFD40 +9C5FFF29B40110381ED22F58CA53CB2407E5B993930DE5E32CBC4CDB2FC46604 +AE51C1375F9A41D7B5CB2B2FA52F65CB925BDA5CE18BDCFC46933071789E3F20 +C08FC64F367F409C38279E5F88EDFBEE38105A2469CF009344F9E846419519E5 +8A5EC45DE2F6837C65A883C524305D18769A563691F5887D920CAA8EF0D9D56F +F208395E7390570C6DBBE5AF515BF64478059F922068F0E473C020E54CEBF22D +495D5E843839912C58FDE0A61D4E390E4502E9973562BCA49B3A17BCAC0352AE +5C27DA44578C4FA5821B9A3B03FFAA97E15E83CE09AE155BE919EA42301E6195 +F59C0A9131C4089E97223BF614A37B5C7603190DD465105AD86DFEB74E65479B +BBCEC9EF93508604339454483E244A348A78F29EC4A60554E77136749A4A74BE +F4DE4955FFDB6AEEBE19705EA184605994D2A5284C05A479A33D56FF398DDF3C +5B474F53743255BD5F42DADADD7F71BAC446A10084DE15876FF74765654405C3 +470144E2902EF213A594FB721D0B0FD823DAC347777B7AA58688EA834514299F +75A3C80BCF2FD24D19650B7D2C21ED664D290EFB9122C125F5DE1B2C4A817905 +06C27E7188C9BF3965A6A25A5A9C0353A53D05BF64FD4C226837AF6D9599BE70 +04142CC78E03626BF10D68CE17C2D081B3A4248FF392E985A6946D89BE97AF1B +C6BE7E9820405D06F5FFC06D6304028E5697E8AE15225A8FE19CDF3DFA2079A8 +BA537833DDBEB6106BAADD45E9ABD1C7B5157C5CB26F971B0E7EE8069E3C8FD4 +A7A1833B19CB43DE4E7497D505AE0B7BFEBB3E489315842DCB3D6CB7E6E43AEE +E215D011B2854A3CEE5AADB34A9CB5AE595F2F02CC5CAEA9AB28161FD93F3FD5 +87D17D564939ED05A5055029D1AAAD21726C1AEFA777EFEDF8D687D9F2FCA607 +CE3B585E044A8CFFBD6E93849467378BAE5AB8C02615AA974546C3D7AD70AF26 +55C62A9C4EFE256B5303BBD0B9E13544F408F8AFD7265425BE1421FE6B1E41E3 +B6D9C509B4EB820507F2B41A92F93A584AF62987450095DCE78F9862284F0C53 +F46B02549CA9EA57C9C4CA8A0BC1EBE947AFE73B8F7958853BEAF81D78E23C25 +3BEB6EC3823E1DC7524E38CD63577795EC3DDE03027369957906C85A22F9D805 +2EBD287C2CAEE0D3985264AE614380E421EF23453A68F6E616B3191B506113AD +F6D569E4A20D3B23961DFB3ECE07B382AFD2CCB1F2BC4F3C1974C06C8652682B +EE7ED59D4B2F9EB8492FF978747AB12E123932B34C0F9F3335587C7B8B8E13A4 +0E1EE5212AB1671DD7A2AB5AF2373B60B3353C22FF8128198A5245F9C701B6E9 +80E92AB14A77AE7BA217D33ABDED222EEE9B5888AC6653459EA8738703FF7423 +8391380AF83E56A3BDFD3AD43F2F00E87DB9153D99A3B358A38313A7E6D6B43B +07804A9929FE01EE112C0B1960B286C97E7F563D552250DEB189F3467ADE8491 +9C25A473EC8D590BC6EE6E7F340991D4317F1F0E29737ED93D18BA4DEF6A6C0C +F9A71EFDDBE489F1A5E27699F8C120DDBC96C4F3F3F2F90AC5014F78AF6517F3 +3C8E2B548C7BD7CA91ABC4E71930761D5C609CCB41B7CE490389C7CA6B1A7B34 +7130074DADA12806475998153EC604A5FD7A04AF35D00DA9564123A384E39126 +B228353532842504229FD646A0FA1C24AC462A75A119743C17071D0F3C370D04 +2FBBB8155EC868014066C6EFEA257752846195C4158AF9DF215C8B20AE276F50 +67AB636CF7A49D34B26435233460DFF6F728E91F1FC4224A7AB1C991C94D3224 +E75B5764642BF2972C9F72A347861CA23B78BD37E0902CE7E3776E347AB20388 +2F97386F31D1D41B43B5A1F52C11C908155E7C3AD9C818BD5F8AB022FE979EFC +695DB2B79BE6264EF7DEBC936048FF17E81408CC701C0B1C742B11F6D9442E4D +2BE899B3D354D07CDD71FB19ED3972363ACB918BF229ECDF8C5D6F9ABD5263A1 +81A0BB786D0A859C53BBEEF61872E24BB550FDEF14A66FB0C09836F4677DD4FF +26FB82FFD120F2F8947B51B0A38F47E65A8019C88A1C343E144F7CCDD1E9C541 +640452BFC800ACD27D181077E8F59E12CFFD7C67DF26CD9DE94B87A16BCA14D5 +9EC57D1963A82E2E1667BA64E7C10015A22C4C6FA06B9D76A9CF591FBD2003C9 +116043C62347D68F99214E90E01E80D140B1D3E8AF7526C17AC8A2056B63E192 +031101D44760E5679C4FFA2FF739CBA5A80AE9F95DDD80973F32D0411F9A43A3 +887CB08E116C823DF5921C157390E1568C76B82DD9A7C69FC76501712D2F24DE +7478B1FF5F7C648754860E394340F17D90865DF0D75A1A7770C177ED1052E10A +2A60B370A9DE3A6876B9E102A6706E464A91DFF642F498162C9BDB4F0827AA54 +0D1F36557B76DC6FAB62E52078C40F608CBE6C447CCD32A29C9751C53ED48951 +3E2466B2BC8C28CF21A439CF54B50E6DEA50761A23333E8E96233215BE86B870 +461D46D227790B1E65198B0C32C44F9861B94EDC731836D157B0B3419AB6AA9F +41BEF201D3637F1F6C3F7DCB71BD670EC111B24C411D0AE3310DFC4C9279BCB8 +F5D936F0211B5FC10B7957259D2C3874724EDF11A646D951E79CD958B60EB6E8 +071CD06657B15B5D0BF492312911076FA5E74F7DD94729A1A17393FE5891280B +D0BA2F31DFA6B3E01C0C0F662D02EF94590EDA84EDEFE9F28F5E7DE75B79D8F9 +4178ACBA78D1F147820EF76DB4850910C3249DCE6EA13C1161DA6EC36BC129FF +E9C97EFAF481A1605F788CDD66DAC83A95BF09FA47850FA0D7A844AB7014D9C4 +95A1C6AF0D3AA8A0DBE08FAF4E4FF7D6039F6115845EF41EEBC31D1D6B2CA95C +FB29A10E77935F79EC66A5D14FA898CF1347CA2502496BFC44DC1057AD6B00D9 +E22C8A982C04B48494C7B1C630FFB2FD1701F65B0558C5A2BE9C5A017B3788A4 +B9A22CA8E87600A54D570A6391D814FB95FCCA3631B123AD03A9EE0ECF9A8B6B +A5C050A34767371D99220A3395B8EEE63067AD64C93F4323A1C33BAAB8ED8B85 +FB1F71CCB36B381463157A5F19F0CD76CA14C77839BE94271264F5B454044D8F +4458AF7DC8A85ACD3EC014E424D102D2FED460A7AC342E23B960846056031213 +25CAE1315149CC2069E8963AB540265026F4B11BABD9C4711875217188D5B5DB +6E9CC8E436A56D53B37809295276DC0A21F0CF2D50CD5FEA1AD417F1098A8999 +F4163AEA50ACBF468E0863C901DC518029692C076C5BBD7954DEE6504EBB39CE +8F680420CEE573D8338DB67A5BB2B5361734D36D029812BF3AF22AE71CC4BE7C +8C0E047CA409DA46AA3EF4E6B345A3E1A53A9892A1943BB32ECFD340439C1D52 +14BC35A77EE696CF792BC25DE49B75F3B04F09704B64C8B1EA9FF39E6E8D9B4C +A39ADDE4B5B49E3FBE3A7F0AC51988057E46379173D5D3AB9E786EDF308B5F0A +5B2DA6D030F881DFA0D479D8D6D97D66F3D25ED946128B38DECFD701E607221D +EE1069CADB078D3434253AA89970029EADFE217FF24C825718F68575379A653A +0024F720B6355DB4C7EA81077DC68DD6DC61F85C2AE59E28FE04234E7887A9DA +E4E9E36FB0012C49B48F057C1E98380639744B5EF0B135596964BB2F020ADF92 +812966653E399B2EF9D5044A6F8E2C788EAEF6108AEB70166157E322EB549002 +12A5FC7F4DB295C0DC64BE331D154D07E49DB9090DA8194B941117326D763EA0 +4CCC8B7F97881190EA60F9D0B33BD2DFF04BA5AC81143068D66DBA61A08D3930 +439A0A87540C2CD06F56A3D732CA041DCA2F74DFB4CD05FBD76455E389095AEB +4CE5ED7BE40BFE6003C9D6534F19D150FF8AF8DA936D0739EBE9128BCAD016BE +70EAC25338227E83963F81AD1466C3618B8044AFA276879B9E621F00B96B0B67 +2E8C2D95E222EA6F4586EC05BE9768957AC121965B9BBF9481EA4C513BC092F9 +A4D44F4F949E5537C1F59F74B48AFAFA371F62823286B5E005EADCC936729DAC +4817750D66C15D3508DAEF758FDFB5C84245DF6C040EC0A91B207A1377DEEC10 +5387A82D27199E8826C00B44A5C2A4DC784B1A8288769428FD632D7AF1C3508C +C42FC3ECAE21E060637D961D448568FBF539B8E85B7AD60F1A573995C7857AD9 +9755535F9D04B4ADD5DF7EAAAA0819A5F21F111D9D9821089D071907307025F9 +B6E4C4DCB3E7F6F06492BA6EEF4F32B38393CB787BA9E00D8F60A8B4CC91B228 +0FADC305AC966F9C2547DAE80B4F60959658AEFBFF9F63B95F106EA226978D84 +C7863BEA1C71B13A5FDAC35FE9D7037758574081CB58AF6DDE2C80E90ABC48E6 +DC0716B13DD52ECE01079EE01A114E444C1F09AA1788356432E51806D996A99A +BF169DFBE02DF5728D88FEC214B3B272CB1A7C9B9168F302B505C54584A0B428 +17CBA6046E0319FB5041FB9319E75E7F805232DBE8312E63C639F35CD679638A +60E1B0BAE1F1F9D359A2786AB8838694270C368D7BC92E9D65D119BF317B8909 +7BFD7AF55533BCA289460558977CFC99E3E89D0C4A3B50C17DE43E2A7D7210E0 +96F0B6BA7A4C654A8C59DF2DD5881BE5AFACB64489FEC5B129ABFB10FA17B3A7 +426E2445778B53336CE63969C5F3567DC66DEF49A7D1A6C19C84EDE1C2FDDA4D +4FA5854F4F15C7FC1AC8175587087D068E2150D05141970845D173E5312CAC9F +8B9CAA28EC46FBDDF610B9371BAC2F577ACFF2F7CE3634CB13941BD437390F84 +ED894384E3130E663F5C0EE25C2C8096B7BF90F7783FE1B00F6EB78D92DC41D6 +BADF384149742D6B9CCF1BA890446599FD957258E9E3041201B958C2E5BA6842 +32176AB1367690BF1AE79B6075315D538C7D6634117A20DD82FD8067F5237B5C +C93F4989D054A45FEA482AA961738EF0B9CA8D6711DA94A512BA132038866CF6 +E59012950C870598644FC143CB205494BB65EB649FDD6157FACC5814014C5B46 +1153221D8F2D3B3FAFEB01DFF0BEAA0C00353668793379A88FD7C9827277860C +516724161906BE5B164E 0000000000000000000000000000000000000000000000000000000000000000 0000000000000000000000000000000000000000000000000000000000000000 0000000000000000000000000000000000000000000000000000000000000000 @@ -7555,7 +7565,7 @@ TeXDict begin 40258431 52099146 1000 600 600 (bashref.dvi) 116 74 96 1[46 96 96 77 81 94 89 87 93 1[58 5[61 61 61 61 61 61 61 61 61 61 1[34 41 34 31[68 72 11[{}62 109.091 /CMBX12 rf /Fl 135[42 1[42 1[30 37 38 1[46 46 51 74 23 -2[28 1[42 1[42 46 42 1[46 51[33 32[51 12[{}18 90.9091 +42 1[28 1[42 1[42 46 42 1[46 51[33 32[51 12[{}19 90.9091 /CMTI10 rf /Fm 135[56 2[56 1[42 55 1[51 58 56 68 47 2[27 1[58 49 51 57 54 53 56 46[50 2[50 1[34 45[{}20 90.9091 /CMCSC10 rf /Fn 197[25 58[{}1 90.9091 /CMMI10 rf /Fo @@ -7604,7 +7614,7 @@ ifelse TeXDict begin 1 0 bop 150 1318 a Fv(Bash)64 b(Reference)j(Man)-5 b(ual)p 150 1385 3600 34 v 2361 1481 a Fu(Reference)31 b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(5.1,)g(for)f -Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.1.)3350 1697 y(June)e(2020)150 +Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.1.)3252 1697 y(August)f(2020)150 4927 y Fs(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11 @@ -7612,10 +7622,10 @@ b(oundation)p 150 5141 3600 17 v eop end %%Page: 2 2 TeXDict begin 2 1 bop 150 4279 a Fu(This)35 b(text)h(is)g(a)g(brief)f (description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f -(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.1,)c(5)e(June)g -(2020\).)150 4523 y(This)37 b(is)h(Edition)f(5.1,)k(last)e(up)s(dated)d -(5)i(June)f(2020,)k(of)d Fr(The)f(GNU)h(Bash)g(Reference)h(Man)m(ual)p -Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31 +(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.1,)c(25)f(August)f +(2020\).)150 4523 y(This)e(is)g(Edition)h(5.1,)h(last)f(up)s(dated)e +(25)i(August)f(2020,)j(of)e Fr(The)f(GNU)h(Bash)f(Reference)h(Man)m +(ual)p Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)f(V)-8 b(ersion)31 b(5.1.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767 y Fq(\015)f Fu(1988{2018)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h @@ -8001,13 +8011,13 @@ b Fn(:)16 b(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h 3050 y(8.4.6)93 b(Letting)31 b(Readline)g(T)m(yp)s(e)f(F)-8 b(or)31 b(Y)-8 b(ou)20 b Fn(:)c(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f (:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)33 -b Fu(132)399 3160 y(8.4.7)93 b(Keyb)s(oard)29 b(Macros)9 +b Fu(133)399 3160 y(8.4.7)93 b(Keyb)s(oard)29 b(Macros)9 b Fn(:)17 b(:)e(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h (:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:) h(:)f(:)h(:)f(:)g(:)h(:)22 b Fu(134)399 3269 y(8.4.8)93 b(Some)30 b(Miscellaneous)j(Commands)14 b Fn(:)f(:)j(:)f(:)h(:)f(:)g(:) h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h -(:)f(:)27 b Fu(134)275 3379 y(8.5)92 b(Readline)31 b(vi)f(Mo)s(de)e +(:)f(:)27 b Fu(135)275 3379 y(8.5)92 b(Readline)31 b(vi)f(Mo)s(de)e Fn(:)16 b(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h (:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:) f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)41 b Fu(137)275 @@ -10631,142 +10641,144 @@ TeXDict begin 35 40 bop 150 -116 a Fu(Chapter)30 b(3:)41 b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(35)150 299 y(matc)m(hes)38 b(against)g(shorter)e(strings,)i(or)f(using)f(arra)m (ys)h(of)g(strings)f(instead)h(of)g(a)g(single)g(long)h(string,)150 -408 y(ma)m(y)31 b(b)s(e)f(faster.)150 598 y Fk(3.5.9)63 -b(Quote)41 b(Remo)m(v)-7 b(al)150 745 y Fu(After)32 b(the)g(preceding)g +408 y(ma)m(y)31 b(b)s(e)f(faster.)150 614 y Fk(3.5.9)63 +b(Quote)41 b(Remo)m(v)-7 b(al)150 760 y Fu(After)32 b(the)g(preceding)g (expansions,)h(all)f(unquoted)f(o)s(ccurrences)h(of)g(the)h(c)m (haracters)g(`)p Ft(\\)p Fu(',)g(`)p Ft(')p Fu(',)f(and)g(`)p -Ft(")p Fu(')150 854 y(that)f(did)f(not)g(result)g(from)g(one)h(of)g +Ft(")p Fu(')150 870 y(that)f(did)f(not)g(result)g(from)g(one)h(of)g (the)f(ab)s(o)m(v)m(e)i(expansions)e(are)h(remo)m(v)m(ed.)150 -1085 y Fs(3.6)68 b(Redirections)150 1245 y Fu(Before)32 +1120 y Fs(3.6)68 b(Redirections)150 1279 y Fu(Before)32 b(a)f(command)f(is)h(executed,)h(its)f(input)e(and)h(output)h(ma)m(y)g (b)s(e)f Fr(redirected)k Fu(using)c(a)i(sp)s(ecial)f(no-)150 -1354 y(tation)d(in)m(terpreted)f(b)m(y)f(the)h(shell.)40 +1389 y(tation)d(in)m(terpreted)f(b)m(y)f(the)h(shell.)40 b(Redirection)27 b(allo)m(ws)h(commands')f(\014le)f(handles)g(to)i(b)s -(e)e(duplicated,)150 1464 y(op)s(ened,)i(closed,)i(made)e(to)h(refer)f +(e)e(duplicated,)150 1498 y(op)s(ened,)i(closed,)i(made)e(to)h(refer)f (to)h(di\013eren)m(t)f(\014les,)h(and)f(can)g(c)m(hange)h(the)g -(\014les)f(the)g(command)g(reads)150 1573 y(from)39 b(and)g(writes)h +(\014les)f(the)g(command)g(reads)150 1608 y(from)39 b(and)g(writes)h (to.)69 b(Redirection)40 b(ma)m(y)g(also)h(b)s(e)e(used)g(to)h(mo)s (dify)f(\014le)g(handles)g(in)g(the)h(curren)m(t)150 -1683 y(shell)e(execution)h(en)m(vironmen)m(t.)65 b(The)37 +1717 y(shell)e(execution)h(en)m(vironmen)m(t.)65 b(The)37 b(follo)m(wing)j(redirection)f(op)s(erators)f(ma)m(y)g(precede)h(or)f -(app)s(ear)150 1793 y(an)m(ywhere)30 b(within)f(a)h(simple)f(command)h +(app)s(ear)150 1827 y(an)m(ywhere)30 b(within)f(a)h(simple)f(command)h (or)f(ma)m(y)i(follo)m(w)g(a)f(command.)40 b(Redirections)30 -b(are)g(pro)s(cessed)150 1902 y(in)g(the)h(order)f(they)g(app)s(ear,)g -(from)g(left)h(to)g(righ)m(t.)275 2032 y(Eac)m(h)45 b(redirection)h +b(are)g(pro)s(cessed)150 1936 y(in)g(the)h(order)f(they)g(app)s(ear,)g +(from)g(left)h(to)g(righ)m(t.)275 2077 y(Eac)m(h)45 b(redirection)h (that)f(ma)m(y)h(b)s(e)e(preceded)g(b)m(y)h(a)h(\014le)f(descriptor)f -(n)m(um)m(b)s(er)g(ma)m(y)h(instead)h(b)s(e)150 2141 +(n)m(um)m(b)s(er)g(ma)m(y)h(instead)h(b)s(e)150 2186 y(preceded)41 b(b)m(y)g(a)h(w)m(ord)f(of)g(the)h(form)f Fi({)p Fr(v)-5 b(arname)5 b Fi(})p Fu(.)74 b(In)41 b(this)g(case,)k -(for)c(eac)m(h)i(redirection)f(op)s(erator)150 2251 y(except)30 -b Ft(>)p Fu(&-)f(and)f Ft(<)p Fu(&-,)h(the)g(shell)g(will)h(allo)s -(cate)h(a)e(\014le)h(descriptor)e(greater)j(than)d(10)i(and)e(assign)i -(it)f(to)150 2361 y Fi({)p Fr(v)-5 b(arname)5 b Fi(})p -Fu(.)45 b(If)31 b Ft(>)p Fu(&-)g(or)h Ft(<)p Fu(&-)f(is)h(preceded)f(b) -m(y)g Fi({)p Fr(v)-5 b(arname)5 b Fi(})p Fu(,)33 b(the)f(v)-5 -b(alue)32 b(of)g Fr(v)-5 b(arname)36 b Fu(de\014nes)31 -b(the)h(\014le)150 2470 y(descriptor)i(to)g(close.)52 -b(If)34 b Fi({)p Fr(v)-5 b(arname)5 b Fi(})34 b Fu(is)g(supplied,)g -(the)g(redirection)g(p)s(ersists)f(b)s(ey)m(ond)g(the)h(scop)s(e)g(of) -150 2580 y(the)d(command,)f(allo)m(wing)i(the)f(shell)f(programmer)g -(to)h(manage)h(the)e(\014le)h(descriptor)f(himself.)275 -2709 y(In)d(the)i(follo)m(wing)h(descriptions,)g(if)e(the)h(\014le)g -(descriptor)f(n)m(um)m(b)s(er)g(is)g(omitted,)i(and)f(the)f(\014rst)g -(c)m(har-)150 2819 y(acter)42 b(of)f(the)g(redirection)g(op)s(erator)g -(is)g(`)p Ft(<)p Fu(',)i(the)e(redirection)g(refers)g(to)g(the)g -(standard)f(input)f(\(\014le)150 2928 y(descriptor)33 -b(0\).)49 b(If)33 b(the)g(\014rst)f(c)m(haracter)i(of)g(the)f -(redirection)g(op)s(erator)h(is)f(`)p Ft(>)p Fu(',)h(the)f(redirection) -g(refers)150 3038 y(to)e(the)g(standard)e(output)h(\(\014le)h -(descriptor)f(1\).)275 3168 y(The)h(w)m(ord)h(follo)m(wing)i(the)f -(redirection)g(op)s(erator)f(in)g(the)h(follo)m(wing)h(descriptions,)f -(unless)e(other-)150 3277 y(wise)21 b(noted,)i(is)e(sub)5 -b(jected)21 b(to)h(brace)f(expansion,)i(tilde)f(expansion,)h(parameter) -e(expansion,)i(command)150 3387 y(substitution,)31 b(arithmetic)h -(expansion,)f(quote)h(remo)m(v)-5 b(al,)33 b(\014lename)e(expansion,)g -(and)f(w)m(ord)h(splitting.)150 3496 y(If)f(it)h(expands)e(to)i(more)g -(than)f(one)h(w)m(ord,)f(Bash)h(rep)s(orts)e(an)h(error.)275 -3626 y(Note)h(that)g(the)g(order)f(of)g(redirections)h(is)g -(signi\014can)m(t.)41 b(F)-8 b(or)31 b(example,)h(the)e(command)390 -3756 y Ft(ls)47 b(>)h Fj(dirlist)d Ft(2>&1)150 3885 y -Fu(directs)28 b(b)s(oth)f(standard)g(output)g(\(\014le)h(descriptor)f -(1\))i(and)e(standard)f(error)i(\(\014le)g(descriptor)f(2\))h(to)h(the) -150 3995 y(\014le)h Fr(dirlist)p Fu(,)h(while)f(the)h(command)390 -4124 y Ft(ls)47 b(2>&1)g(>)g Fj(dirlist)150 4254 y Fu(directs)28 +(for)c(eac)m(h)i(redirection)f(op)s(erator)150 2296 y(except)37 +b Ft(>)p Fu(&-)e(and)g Ft(<)p Fu(&-,)i(the)f(shell)g(will)g(allo)s +(cate)j(a)d(\014le)g(descriptor)f(greater)i(than)f(10)g(and)f(assign)h +(it)150 2406 y(to)e Fi({)p Fr(v)-5 b(arname)5 b Fi(})p +Fu(.)52 b(If)33 b Ft(>)p Fu(&-)g(or)h Ft(<)p Fu(&-)f(is)g(preceded)h(b) +m(y)f Fi({)p Fr(v)-5 b(arname)5 b Fi(})p Fu(,)36 b(the)e(v)-5 +b(alue)34 b(of)f Fr(v)-5 b(arname)39 b Fu(de\014nes)33 +b(the)150 2515 y(\014le)e(descriptor)g(to)h(close.)43 +b(If)31 b Fi({)p Fr(v)-5 b(arname)5 b Fi(})32 b Fu(is)f(supplied,)f +(the)h(redirection)g(p)s(ersists)f(b)s(ey)m(ond)h(the)g(scop)s(e)150 +2625 y(of)42 b(the)f(command,)j(allo)m(wing)f(the)f(shell)g(programmer) +f(to)h(manage)g(the)g(\014le)f(descriptor's)h(lifetime)150 +2734 y(man)m(ually)-8 b(.)275 2875 y(In)27 b(the)i(follo)m(wing)h +(descriptions,)g(if)e(the)h(\014le)g(descriptor)f(n)m(um)m(b)s(er)g(is) +g(omitted,)i(and)f(the)f(\014rst)g(c)m(har-)150 2984 +y(acter)42 b(of)f(the)g(redirection)g(op)s(erator)g(is)g(`)p +Ft(<)p Fu(',)i(the)e(redirection)g(refers)g(to)g(the)g(standard)f +(input)f(\(\014le)150 3094 y(descriptor)33 b(0\).)49 +b(If)33 b(the)g(\014rst)f(c)m(haracter)i(of)g(the)f(redirection)g(op)s +(erator)h(is)f(`)p Ft(>)p Fu(',)h(the)f(redirection)g(refers)150 +3203 y(to)e(the)g(standard)e(output)h(\(\014le)h(descriptor)f(1\).)275 +3344 y(The)h(w)m(ord)h(follo)m(wing)i(the)f(redirection)g(op)s(erator)f +(in)g(the)h(follo)m(wing)h(descriptions,)f(unless)e(other-)150 +3453 y(wise)21 b(noted,)i(is)e(sub)5 b(jected)21 b(to)h(brace)f +(expansion,)i(tilde)f(expansion,)h(parameter)e(expansion,)i(command)150 +3563 y(substitution,)31 b(arithmetic)h(expansion,)f(quote)h(remo)m(v)-5 +b(al,)33 b(\014lename)e(expansion,)g(and)f(w)m(ord)h(splitting.)150 +3672 y(If)f(it)h(expands)e(to)i(more)g(than)f(one)h(w)m(ord,)f(Bash)h +(rep)s(orts)e(an)h(error.)275 3813 y(Note)h(that)g(the)g(order)f(of)g +(redirections)h(is)g(signi\014can)m(t.)41 b(F)-8 b(or)31 +b(example,)h(the)e(command)390 3953 y Ft(ls)47 b(>)h +Fj(dirlist)d Ft(2>&1)150 4093 y Fu(directs)28 b(b)s(oth)f(standard)g +(output)g(\(\014le)h(descriptor)f(1\))i(and)e(standard)f(error)i +(\(\014le)g(descriptor)f(2\))h(to)h(the)150 4203 y(\014le)h +Fr(dirlist)p Fu(,)h(while)f(the)h(command)390 4343 y +Ft(ls)47 b(2>&1)g(>)g Fj(dirlist)150 4484 y Fu(directs)28 b(only)f(the)h(standard)e(output)i(to)g(\014le)f Fr(dirlist)p Fu(,)h(b)s(ecause)g(the)f(standard)g(error)g(w)m(as)h(made)f(a)h(cop)m -(y)150 4363 y(of)j(the)f(standard)g(output)g(b)s(efore)g(the)g +(y)150 4593 y(of)j(the)f(standard)g(output)g(b)s(efore)g(the)g (standard)g(output)g(w)m(as)g(redirected)h(to)g Fr(dirlist)p -Fu(.)275 4493 y(Bash)26 b(handles)f(sev)m(eral)j(\014lenames)e(sp)s +Fu(.)275 4733 y(Bash)26 b(handles)f(sev)m(eral)j(\014lenames)e(sp)s (ecially)h(when)f(they)g(are)g(used)g(in)g(redirections,)i(as)e -(describ)s(ed)150 4603 y(in)38 b(the)h(follo)m(wing)h(table.)66 +(describ)s(ed)150 4843 y(in)38 b(the)h(follo)m(wing)h(table.)66 b(If)38 b(the)h(op)s(erating)g(system)f(on)h(whic)m(h)f(Bash)h(is)f -(running)f(pro)m(vides)h(these)150 4712 y(sp)s(ecial)27 +(running)f(pro)m(vides)h(these)150 4953 y(sp)s(ecial)27 b(\014les,)g(bash)e(will)i(use)f(them;)h(otherwise)g(it)f(will)h(em)m (ulate)h(them)e(in)m(ternally)h(with)f(the)g(b)s(eha)m(vior)150 -4822 y(describ)s(ed)j(b)s(elo)m(w.)150 4971 y Ft(/dev/fd/)p -Fj(fd)630 5081 y Fu(If)h Fr(fd)j Fu(is)d(a)h(v)-5 b(alid)31 -b(in)m(teger,)h(\014le)e(descriptor)h Fr(fd)i Fu(is)d(duplicated.)150 -5230 y Ft(/dev/stdin)630 5340 y Fu(File)i(descriptor)e(0)h(is)f -(duplicated.)p eop end +5062 y(describ)s(ed)j(b)s(elo)m(w.)150 5230 y Ft(/dev/fd/)p +Fj(fd)630 5340 y Fu(If)h Fr(fd)j Fu(is)d(a)h(v)-5 b(alid)31 +b(in)m(teger,)h(\014le)e(descriptor)h Fr(fd)i Fu(is)d(duplicated.)p +eop end %%Page: 36 42 TeXDict begin 36 41 bop 150 -116 a Fu(Chapter)30 b(3:)41 b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(36)150 299 -y Ft(/dev/stdout)630 408 y Fu(File)32 b(descriptor)e(1)h(is)f -(duplicated.)150 595 y Ft(/dev/stderr)630 705 y Fu(File)i(descriptor)e -(2)h(is)f(duplicated.)150 892 y Ft(/dev/tcp/)p Fj(host)p -Ft(/)p Fj(port)630 1001 y Fu(If)41 b Fr(host)i Fu(is)f(a)g(v)-5 -b(alid)41 b(hostname)h(or)f(In)m(ternet)h(address,)i(and)c -Fr(p)s(ort)j Fu(is)f(an)f(in)m(teger)i(p)s(ort)630 1111 -y(n)m(um)m(b)s(er)23 b(or)i(service)h(name,)g(Bash)f(attempts)h(to)f -(op)s(en)f(the)h(corresp)s(onding)f(TCP)g(so)s(c)m(k)m(et.)150 -1298 y Ft(/dev/udp/)p Fj(host)p Ft(/)p Fj(port)630 1407 -y Fu(If)41 b Fr(host)i Fu(is)f(a)g(v)-5 b(alid)41 b(hostname)h(or)f(In) -m(ternet)h(address,)i(and)c Fr(p)s(ort)j Fu(is)f(an)f(in)m(teger)i(p)s -(ort)630 1517 y(n)m(um)m(b)s(er)23 b(or)h(service)h(name,)h(Bash)e -(attempts)h(to)g(op)s(en)f(the)g(corresp)s(onding)f(UDP)i(so)s(c)m(k)m -(et.)275 1718 y(A)30 b(failure)h(to)g(op)s(en)e(or)i(create)h(a)e -(\014le)h(causes)g(the)f(redirection)h(to)g(fail.)275 -1880 y(Redirections)f(using)e(\014le)i(descriptors)f(greater)h(than)f -(9)h(should)e(b)s(e)h(used)f(with)h(care,)h(as)g(they)f(ma)m(y)150 -1989 y(con\015ict)i(with)f(\014le)h(descriptors)f(the)g(shell)h(uses)f -(in)m(ternally)-8 b(.)150 2216 y Fk(3.6.1)63 b(Redirecting)40 -b(Input)150 2363 y Fu(Redirection)35 b(of)f(input)f(causes)i(the)f -(\014le)g(whose)g(name)g(results)g(from)g(the)g(expansion)g(of)g -Fr(w)m(ord)k Fu(to)d(b)s(e)150 2473 y(op)s(ened)d(for)g(reading)g(on)g -(\014le)h(descriptor)f Ft(n)p Fu(,)h(or)f(the)g(standard)g(input)f -(\(\014le)i(descriptor)f(0\))h(if)f Ft(n)g Fu(is)h(not)150 -2582 y(sp)s(eci\014ed.)275 2744 y(The)c(general)j(format)e(for)h -(redirecting)g(input)e(is:)390 2906 y Ft([)p Fj(n)p Ft(]<)p -Fj(word)150 3133 y Fk(3.6.2)63 b(Redirecting)40 b(Output)150 -3280 y Fu(Redirection)31 b(of)g(output)f(causes)h(the)f(\014le)h(whose) +y Ft(/dev/stdin)630 408 y Fu(File)32 b(descriptor)e(0)h(is)f +(duplicated.)150 577 y Ft(/dev/stdout)630 687 y Fu(File)i(descriptor)e +(1)h(is)f(duplicated.)150 856 y Ft(/dev/stderr)630 965 +y Fu(File)i(descriptor)e(2)h(is)f(duplicated.)150 1134 +y Ft(/dev/tcp/)p Fj(host)p Ft(/)p Fj(port)630 1244 y +Fu(If)41 b Fr(host)i Fu(is)f(a)g(v)-5 b(alid)41 b(hostname)h(or)f(In)m +(ternet)h(address,)i(and)c Fr(p)s(ort)j Fu(is)f(an)f(in)m(teger)i(p)s +(ort)630 1354 y(n)m(um)m(b)s(er)23 b(or)i(service)h(name,)g(Bash)f +(attempts)h(to)f(op)s(en)f(the)h(corresp)s(onding)f(TCP)g(so)s(c)m(k)m +(et.)150 1522 y Ft(/dev/udp/)p Fj(host)p Ft(/)p Fj(port)630 +1632 y Fu(If)41 b Fr(host)i Fu(is)f(a)g(v)-5 b(alid)41 +b(hostname)h(or)f(In)m(ternet)h(address,)i(and)c Fr(p)s(ort)j +Fu(is)f(an)f(in)m(teger)i(p)s(ort)630 1742 y(n)m(um)m(b)s(er)23 +b(or)h(service)h(name,)h(Bash)e(attempts)h(to)g(op)s(en)f(the)g +(corresp)s(onding)f(UDP)i(so)s(c)m(k)m(et.)275 1915 y(A)30 +b(failure)h(to)g(op)s(en)e(or)i(create)h(a)e(\014le)h(causes)g(the)f +(redirection)h(to)g(fail.)275 2059 y(Redirections)f(using)e(\014le)i +(descriptors)f(greater)h(than)f(9)h(should)e(b)s(e)h(used)f(with)h +(care,)h(as)g(they)f(ma)m(y)150 2169 y(con\015ict)i(with)f(\014le)h +(descriptors)f(the)g(shell)h(uses)f(in)m(ternally)-8 +b(.)150 2378 y Fk(3.6.1)63 b(Redirecting)40 b(Input)150 +2525 y Fu(Redirection)35 b(of)f(input)f(causes)i(the)f(\014le)g(whose)g +(name)g(results)g(from)g(the)g(expansion)g(of)g Fr(w)m(ord)k +Fu(to)d(b)s(e)150 2634 y(op)s(ened)d(for)g(reading)g(on)g(\014le)h +(descriptor)f Ft(n)p Fu(,)h(or)f(the)g(standard)g(input)f(\(\014le)i +(descriptor)f(0\))h(if)f Ft(n)g Fu(is)h(not)150 2744 +y(sp)s(eci\014ed.)275 2888 y(The)c(general)j(format)e(for)h +(redirecting)g(input)e(is:)390 3032 y Ft([)p Fj(n)p Ft(]<)p +Fj(word)150 3241 y Fk(3.6.2)63 b(Redirecting)40 b(Output)150 +3388 y Fu(Redirection)31 b(of)g(output)f(causes)h(the)f(\014le)h(whose) f(name)g(results)h(from)e(the)i(expansion)f(of)h Fr(w)m(ord)i -Fu(to)f(b)s(e)150 3389 y(op)s(ened)d(for)g(writing)g(on)g(\014le)h +Fu(to)f(b)s(e)150 3497 y(op)s(ened)d(for)g(writing)g(on)g(\014le)h (descriptor)f Fr(n)p Fu(,)g(or)g(the)h(standard)e(output)h(\(\014le)h -(descriptor)f(1\))h(if)g Fr(n)e Fu(is)i(not)150 3499 +(descriptor)f(1\))h(if)g Fr(n)e Fu(is)i(not)150 3607 y(sp)s(eci\014ed.)40 b(If)30 b(the)g(\014le)h(do)s(es)f(not)h(exist)g (it)g(is)f(created;)i(if)e(it)h(do)s(es)f(exist)h(it)g(is)g(truncated)f -(to)h(zero)g(size.)275 3661 y(The)e(general)j(format)e(for)h -(redirecting)g(output)f(is:)390 3823 y Ft([)p Fj(n)p -Ft(]>[|])p Fj(word)275 3985 y Fu(If)g(the)h(redirection)g(op)s(erator)g +(to)h(zero)g(size.)275 3751 y(The)e(general)j(format)e(for)h +(redirecting)g(output)f(is:)390 3895 y Ft([)p Fj(n)p +Ft(]>[|])p Fj(word)275 4039 y Fu(If)g(the)h(redirection)g(op)s(erator)g (is)g(`)p Ft(>)p Fu(',)g(and)f(the)h Ft(noclobber)d Fu(option)j(to)g -(the)g Ft(set)f Fu(builtin)g(has)h(b)s(een)150 4094 y(enabled,)h(the)g +(the)g Ft(set)f Fu(builtin)g(has)h(b)s(een)150 4148 y(enabled,)h(the)g (redirection)h(will)f(fail)h(if)e(the)i(\014le)e(whose)h(name)g (results)g(from)f(the)h(expansion)g(of)g Fr(w)m(ord)150 -4204 y Fu(exists)f(and)f(is)g(a)h(regular)g(\014le.)41 +4258 y Fu(exists)f(and)f(is)g(a)h(regular)g(\014le.)41 b(If)30 b(the)h(redirection)g(op)s(erator)g(is)f(`)p Ft(>|)p Fu(',)h(or)f(the)h(redirection)g(op)s(erator)g(is)150 -4314 y(`)p Ft(>)p Fu(')36 b(and)f(the)g Ft(noclobber)e +4367 y(`)p Ft(>)p Fu(')36 b(and)f(the)g Ft(noclobber)e Fu(option)j(is)g(not)g(enabled,)h(the)e(redirection)h(is)g(attempted)g -(ev)m(en)h(if)e(the)h(\014le)150 4423 y(named)30 b(b)m(y)g -Fr(w)m(ord)k Fu(exists.)150 4650 y Fk(3.6.3)63 b(App)s(ending)42 -b(Redirected)e(Output)150 4797 y Fu(Redirection)23 b(of)e(output)h(in)f +(ev)m(en)h(if)e(the)h(\014le)150 4477 y(named)30 b(b)m(y)g +Fr(w)m(ord)k Fu(exists.)150 4686 y Fk(3.6.3)63 b(App)s(ending)42 +b(Redirected)e(Output)150 4833 y Fu(Redirection)23 b(of)e(output)h(in)f (this)h(fashion)f(causes)h(the)g(\014le)g(whose)f(name)h(results)f -(from)g(the)h(expansion)g(of)150 4906 y Fr(w)m(ord)28 +(from)g(the)h(expansion)g(of)150 4942 y Fr(w)m(ord)28 b Fu(to)e(b)s(e)e(op)s(ened)g(for)h(app)s(ending)e(on)i(\014le)g (descriptor)g Fr(n)p Fu(,)g(or)g(the)g(standard)f(output)h(\(\014le)g -(descriptor)150 5016 y(1\))31 b(if)f Fr(n)g Fu(is)h(not)f(sp)s +(descriptor)150 5052 y(1\))31 b(if)f Fr(n)g Fu(is)h(not)f(sp)s (eci\014ed.)40 b(If)30 b(the)h(\014le)f(do)s(es)g(not)h(exist)g(it)g -(is)f(created.)275 5178 y(The)f(general)j(format)e(for)h(app)s(ending)e +(is)f(created.)275 5196 y(The)f(general)j(format)e(for)h(app)s(ending)e (output)h(is:)390 5340 y Ft([)p Fj(n)p Ft(]>>)p Fj(word)p eop end %%Page: 37 43 @@ -11681,16 +11693,16 @@ Fu(.)73 b(The)40 b(p)s(ositional)j(parameters)630 3747 y(from)34 b Fr(n)p Ft(+)p Fu(1)39 b(.)22 b(.)h(.)45 b Ft($#)34 b Fu(are)g(renamed)g(to)h Ft($1)k Fu(.)22 b(.)g(.)46 b Ft($#)p Fu(-)p Fr(n)p Fu(.)51 b(P)m(arameters)36 b(represen)m(ted)e -(b)m(y)g(the)630 3856 y(n)m(um)m(b)s(ers)25 b Ft($#)i -Fu(to)g Ft($#)p Fu(-)p Fr(n)p Ft(+)p Fu(1)g(are)g(unset.)39 -b Fr(n)26 b Fu(m)m(ust)h(b)s(e)f(a)i(non-negativ)m(e)h(n)m(um)m(b)s(er) -c(less)i(than)g(or)630 3966 y(equal)33 b(to)h Ft($#)p -Fu(.)47 b(If)33 b Fr(n)f Fu(is)h(zero)g(or)g(greater)h(than)f -Ft($#)p Fu(,)g(the)g(p)s(ositional)g(parameters)g(are)h(not)630 -4075 y(c)m(hanged.)48 b(If)32 b Fr(n)g Fu(is)h(not)f(supplied,)h(it)g -(is)f(assumed)g(to)h(b)s(e)f(1.)48 b(The)32 b(return)g(status)h(is)f -(zero)630 4185 y(unless)e Fr(n)f Fu(is)i(greater)g(than)g -Ft($#)e Fu(or)i(less)f(than)h(zero,)g(non-zero)g(otherwise.)150 +(b)m(y)g(the)630 3856 y(n)m(um)m(b)s(ers)d Ft($#)i Fu(do)m(wn)f(to)i +Ft($#)p Fu(-)p Fr(n)p Ft(+)p Fu(1)e(are)h(unset.)48 b +Fr(n)32 b Fu(m)m(ust)h(b)s(e)f(a)h(non-negativ)m(e)i(n)m(um)m(b)s(er)d +(less)630 3966 y(than)g(or)g(equal)h(to)g Ft($#)p Fu(.)46 +b(If)31 b Fr(n)h Fu(is)g(zero)h(or)f(greater)i(than)e +Ft($#)p Fu(,)g(the)h(p)s(ositional)g(parameters)630 4075 +y(are)e(not)h(c)m(hanged.)43 b(If)31 b Fr(n)g Fu(is)g(not)g(supplied,)f +(it)i(is)f(assumed)f(to)i(b)s(e)f(1.)43 b(The)31 b(return)f(status)630 +4185 y(is)g(zero)i(unless)d Fr(n)h Fu(is)g(greater)i(than)e +Ft($#)g Fu(or)g(less)h(than)f(zero,)i(non-zero)e(otherwise.)150 4362 y Ft(test)150 4472 y([)870 4615 y(test)47 b Fj(expr)630 4758 y Fu(Ev)-5 b(aluate)43 b(a)f(conditional)h(expression)f Fr(expr)48 b Fu(and)41 b(return)g(a)h(status)g(of)g(0)g(\(true\))h(or)f @@ -12292,1054 +12304,1056 @@ TeXDict begin 57 62 bop 150 -116 a Fu(Chapter)30 b(4:)41 b(Shell)30 b(Builtin)h(Commands)2069 b(57)630 299 y(Arithmetic],)51 b(page)46 b(93.)87 b(If)45 b(the)g(last)h Fr(expression)g Fu(ev)-5 b(aluates)47 b(to)f(0,)k Ft(let)44 b Fu(returns)g(1;)630 -408 y(otherwise)31 b(0)g(is)f(returned.)150 566 y Ft(local)870 -700 y(local)46 b([)p Fj(option)p Ft(])g Fj(name)p Ft([=)p -Fj(value)p Ft(])e(...)630 833 y Fu(F)-8 b(or)27 b(eac)m(h)g(argumen)m +408 y(otherwise)31 b(0)g(is)f(returned.)150 568 y Ft(local)870 +702 y(local)46 b([)p Fj(option)p Ft(])g Fj(name)p Ft([=)p +Fj(value)p Ft(])e(...)630 836 y Fu(F)-8 b(or)27 b(eac)m(h)g(argumen)m (t,)g(a)f(lo)s(cal)h(v)-5 b(ariable)27 b(named)e Fr(name)31 b Fu(is)26 b(created,)i(and)d(assigned)h Fr(v)-5 b(alue)p -Fu(.)630 943 y(The)37 b Fr(option)h Fu(can)f(b)s(e)g(an)m(y)h(of)f(the) +Fu(.)630 946 y(The)37 b Fr(option)h Fu(can)f(b)s(e)g(an)m(y)h(of)f(the) h(options)g(accepted)g(b)m(y)g Ft(declare)p Fu(.)59 b -Ft(local)36 b Fu(can)i(only)630 1052 y(b)s(e)j(used)h(within)f(a)i +Ft(local)36 b Fu(can)i(only)630 1055 y(b)s(e)j(used)h(within)f(a)i (function;)48 b(it)42 b(mak)m(es)h(the)f(v)-5 b(ariable)43 b Fr(name)48 b Fu(ha)m(v)m(e)43 b(a)f(visible)h(scop)s(e)630 -1162 y(restricted)h(to)f(that)h(function)e(and)g(its)i(c)m(hildren.)78 +1165 y(restricted)h(to)f(that)h(function)e(and)g(its)i(c)m(hildren.)78 b(If)42 b Fr(name)48 b Fu(is)43 b(`)p Ft(-)p Fu(',)j(the)d(set)h(of)f -(shell)630 1271 y(options)34 b(is)f(made)g(lo)s(cal)i(to)f(the)f +(shell)630 1275 y(options)34 b(is)f(made)g(lo)s(cal)i(to)f(the)f (function)g(in)g(whic)m(h)g Ft(local)f Fu(is)h(in)m(v)m(ok)m(ed:)48 -b(shell)34 b(options)630 1381 y(c)m(hanged)e(using)e(the)i +b(shell)34 b(options)630 1384 y(c)m(hanged)e(using)e(the)i Ft(set)e Fu(builtin)h(inside)g(the)g(function)g(are)g(restored)h(to)g -(their)f(original)630 1491 y(v)-5 b(alues)25 b(when)e(the)i(function)f -(returns.)37 b(The)24 b(return)f(status)i(is)f(zero)i(unless)d -Ft(local)g Fu(is)i(used)630 1600 y(outside)k(a)f(function,)h(an)f(in)m -(v)-5 b(alid)29 b Fr(name)k Fu(is)28 b(supplied,)g(or)g -Fr(name)34 b Fu(is)28 b(a)h(readonly)f(v)-5 b(ariable.)150 -1758 y Ft(logout)870 1891 y(logout)46 b([)p Fj(n)p Ft(])630 -2025 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i(status)g(of)f -Fr(n)g Fu(to)h(the)g(shell's)f(paren)m(t.)150 2182 y -Ft(mapfile)870 2316 y(mapfile)46 b([-d)h Fj(delim)p Ft(])f([-n)h +(their)f(original)630 1494 y(v)-5 b(alues)36 b(when)e(the)i(function)f +(returns.)54 b(The)35 b(restore)h(is)g(e\013ected)h(as)e(if)h(a)g +(series)f(of)h Ft(set)630 1603 y Fu(commands)j(w)m(ere)g(executed)h(to) +f(restore)h(the)f(v)-5 b(alues)39 b(that)h(w)m(ere)f(in)f(place)i(b)s +(efore)f(the)630 1713 y(function.)j(The)30 b(return)g(status)h(is)g +(zero)h(unless)e Ft(local)g Fu(is)h(used)f(outside)h(a)g(function,)g +(an)630 1823 y(in)m(v)-5 b(alid)31 b Fr(name)k Fu(is)c(supplied,)e(or)i +Fr(name)k Fu(is)c(a)f(readonly)h(v)-5 b(ariable.)150 +1982 y Ft(logout)870 2116 y(logout)46 b([)p Fj(n)p Ft(])630 +2250 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i(status)g(of)f +Fr(n)g Fu(to)h(the)g(shell's)f(paren)m(t.)150 2409 y +Ft(mapfile)870 2544 y(mapfile)46 b([-d)h Fj(delim)p Ft(])f([-n)h Fj(count)p Ft(])f([-O)h Fj(origin)p Ft(])f([-s)g Fj(count)p -Ft(])1061 2426 y([-t])h([-u)f Fj(fd)p Ft(])h([-C)g Fj(callback)p +Ft(])1061 2653 y([-t])h([-u)f Fj(fd)p Ft(])h([-C)g Fj(callback)p Ft(])f([-c)g Fj(quantum)p Ft(])g([)p Fj(array)p Ft(])630 -2559 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j +2788 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j (the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38 b Fr(arra)m(y)p -Fu(,)i(or)630 2669 y(from)28 b(\014le)h(descriptor)f +Fu(,)i(or)630 2897 y(from)28 b(\014le)h(descriptor)f Fr(fd)k Fu(if)c(the)h Ft(-u)f Fu(option)h(is)g(supplied.)39 b(The)28 b(v)-5 b(ariable)29 b Ft(MAPFILE)e Fu(is)i(the)630 -2778 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30 +3007 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30 b(if)g(supplied,)g(ha)m(v)m(e)h(the)g(follo)m(wing)h(meanings:)630 -2936 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f +3166 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f Fr(delim)g Fu(is)f(used)g(to)h(terminate)h(eac)m(h)g(input)d(line,)1110 -3045 y(rather)41 b(than)h(newline.)74 b(If)41 b Fr(delim)h +3275 y(rather)41 b(than)h(newline.)74 b(If)41 b Fr(delim)h Fu(is)g(the)f(empt)m(y)h(string,)j Ft(mapfile)40 b Fu(will)1110 -3155 y(terminate)31 b(a)g(line)g(when)e(it)i(reads)f(a)h(NUL)g(c)m -(haracter.)630 3313 y Ft(-n)384 b Fu(Cop)m(y)30 b(at)h(most)g +3385 y(terminate)31 b(a)g(line)g(when)e(it)i(reads)f(a)h(NUL)g(c)m +(haracter.)630 3544 y Ft(-n)384 b Fu(Cop)m(y)30 b(at)h(most)g Fr(coun)m(t)i Fu(lines.)41 b(If)30 b Fr(coun)m(t)j Fu(is)d(0,)h(all)h -(lines)e(are)h(copied.)630 3470 y Ft(-O)384 b Fu(Begin)31 +(lines)e(are)h(copied.)630 3703 y Ft(-O)384 b Fu(Begin)31 b(assigning)g(to)g Fr(arra)m(y)39 b Fu(at)31 b(index)f Fr(origin)p Fu(.)41 b(The)30 b(default)h(index)f(is)g(0.)630 -3628 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g Fr(coun)m(t)j -Fu(lines)e(read.)630 3785 y Ft(-t)384 b Fu(Remo)m(v)m(e)32 +3862 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g Fr(coun)m(t)j +Fu(lines)e(read.)630 4021 y Ft(-t)384 b Fu(Remo)m(v)m(e)32 b(a)f(trailing)g Fr(delim)g Fu(\(default)g(newline\))f(from)g(eac)m(h)i -(line)f(read.)630 3943 y Ft(-u)384 b Fu(Read)31 b(lines)f(from)g +(line)f(read.)630 4180 y Ft(-u)384 b Fu(Read)31 b(lines)f(from)g (\014le)h(descriptor)f Fr(fd)j Fu(instead)e(of)f(the)h(standard)e -(input.)630 4100 y Ft(-C)384 b Fu(Ev)-5 b(aluate)26 b +(input.)630 4340 y Ft(-C)384 b Fu(Ev)-5 b(aluate)26 b Fr(callbac)m(k)33 b Fu(eac)m(h)26 b(time)g Fr(quan)m(tum)f Fu(lines)g(are)g(read.)39 b(The)25 b Ft(-c)f Fu(option)1110 -4210 y(sp)s(eci\014es)30 b Fr(quan)m(tum)p Fu(.)630 4367 +4449 y(sp)s(eci\014es)30 b Fr(quan)m(tum)p Fu(.)630 4608 y Ft(-c)384 b Fu(Sp)s(ecify)30 b(the)g(n)m(um)m(b)s(er)f(of)i(lines)f (read)h(b)s(et)m(w)m(een)g(eac)m(h)g(call)h(to)f Fr(callbac)m(k)p -Fu(.)630 4525 y(If)36 b Ft(-C)g Fu(is)g(sp)s(eci\014ed)g(without)g +Fu(.)630 4767 y(If)36 b Ft(-C)g Fu(is)g(sp)s(eci\014ed)g(without)g Ft(-c)p Fu(,)h(the)g(default)f(quan)m(tum)g(is)h(5000.)60 -b(When)36 b Fr(callbac)m(k)44 b Fu(is)630 4634 y(ev)-5 +b(When)36 b Fr(callbac)m(k)44 b Fu(is)630 4877 y(ev)-5 b(aluated,)30 b(it)e(is)g(supplied)f(the)h(index)f(of)i(the)f(next)g (arra)m(y)g(elemen)m(t)h(to)g(b)s(e)e(assigned)i(and)630 -4744 y(the)39 b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i +4986 y(the)39 b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i (as)e(additional)h(argumen)m(ts.)66 b Fr(callbac)m(k)47 -b Fu(is)630 4854 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read) +b Fu(is)630 5096 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read) g(but)g(b)s(efore)g(the)h(arra)m(y)g(elemen)m(t)g(is)g(assigned.)630 -4987 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g +5230 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g Ft(mapfile)c Fu(will)j(clear)g Fr(arra)m(y)34 b Fu(b)s(efore)24 -b(assigning)630 5097 y(to)31 b(it.)630 5230 y Ft(mapfile)41 +b(assigning)630 5340 y(to)31 b(it.)p eop end +%%Page: 58 64 +TeXDict begin 58 63 bop 150 -116 a Fu(Chapter)30 b(4:)41 +b(Shell)30 b(Builtin)h(Commands)2069 b(58)630 299 y Ft(mapfile)41 b Fu(returns)g(successfully)i(unless)e(an)i(in)m(v)-5 b(alid)43 b(option)g(or)g(option)g(argumen)m(t)g(is)630 -5340 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5 +408 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5 b(alid)31 b(or)g(unassignable,)f(or)h Fr(arra)m(y)38 -b Fu(is)31 b(not)f(an)h(indexed)e(arra)m(y)-8 b(.)p eop -end -%%Page: 58 64 -TeXDict begin 58 63 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(58)150 299 y Ft(printf)870 -434 y(printf)46 b([-v)h Fj(var)p Ft(])g Fj(format)f Ft([)p -Fj(arguments)p Ft(])630 570 y Fu(W)-8 b(rite)27 b(the)g(formatted)f -Fr(argumen)m(ts)k Fu(to)d(the)f(standard)f(output)h(under)e(the)i(con)m -(trol)i(of)e(the)630 679 y Fr(format)p Fu(.)66 b(The)39 -b Ft(-v)f Fu(option)h(causes)g(the)g(output)g(to)g(b)s(e)f(assigned)h -(to)h(the)f(v)-5 b(ariable)39 b Fr(v)-5 b(ar)630 789 -y Fu(rather)30 b(than)g(b)s(eing)g(prin)m(ted)g(to)h(the)g(standard)e -(output.)630 924 y(The)36 b Fr(format)i Fu(is)f(a)f(c)m(haracter)i -(string)e(whic)m(h)g(con)m(tains)i(three)e(t)m(yp)s(es)g(of)h(ob)5 -b(jects:)53 b(plain)630 1034 y(c)m(haracters,)41 b(whic)m(h)c(are)h -(simply)e(copied)i(to)g(standard)f(output,)i(c)m(haracter)g(escap)s(e)e -(se-)630 1143 y(quences,)g(whic)m(h)f(are)g(con)m(v)m(erted)h(and)f -(copied)g(to)g(the)g(standard)f(output,)i(and)f(format)630 -1253 y(sp)s(eci\014cations,)j(eac)m(h)e(of)g(whic)m(h)f(causes)g(prin)m -(ting)g(of)h(the)f(next)h(successiv)m(e)g Fr(argumen)m(t)p -Fu(.)630 1363 y(In)24 b(addition)h(to)g(the)g(standard)f -Ft(printf\(1\))e Fu(formats,)27 b Ft(printf)c Fu(in)m(terprets)i(the)f -(follo)m(wing)630 1472 y(extensions:)630 1633 y Ft(\045b)384 -b Fu(Causes)38 b Ft(printf)f Fu(to)j(expand)e(bac)m(kslash)h(escap)s(e) -g(sequences)g(in)f(the)h(cor-)1110 1743 y(resp)s(onding)31 -b Fr(argumen)m(t)j Fu(in)e(the)h(same)f(w)m(a)m(y)h(as)g -Ft(echo)c(-e)j Fu(\(see)h(Section)g(4.2)1110 1852 y([Bash)e(Builtins],) -g(page)g(51\).)630 2014 y Ft(\045q)384 b Fu(Causes)32 -b Ft(printf)e Fu(to)i(output)g(the)g(corresp)s(onding)f -Fr(argumen)m(t)j Fu(in)d(a)i(format)1110 2123 y(that)e(can)g(b)s(e)e -(reused)h(as)h(shell)f(input.)630 2284 y Ft(\045\()p -Fj(datefmt)p Ft(\)T)1110 2394 y Fu(Causes)f Ft(printf)e -Fu(to)j(output)f(the)g(date-time)i(string)e(resulting)h(from)e(using) -1110 2504 y Fr(datefm)m(t)45 b Fu(as)d(a)g(format)g(string)g(for)g -Ft(strftime)p Fu(\(3\).)74 b(The)41 b(corresp)s(onding)1110 -2613 y Fr(argumen)m(t)h Fu(is)e(an)g(in)m(teger)i(represen)m(ting)e -(the)g(n)m(um)m(b)s(er)f(of)h(seconds)g(since)1110 2723 -y(the)24 b(ep)s(o)s(c)m(h.)38 b(Tw)m(o)24 b(sp)s(ecial)h(argumen)m(t)f -(v)-5 b(alues)24 b(ma)m(y)h(b)s(e)e(used:)36 b(-1)25 -b(represen)m(ts)1110 2832 y(the)30 b(curren)m(t)g(time,)h(and)e(-2)i -(represen)m(ts)f(the)g(time)h(the)f(shell)g(w)m(as)g(in)m(v)m(ok)m(ed.) -1110 2942 y(If)38 b(no)g(argumen)m(t)h(is)f(sp)s(eci\014ed,)i(con)m(v)m +b Fu(is)31 b(not)f(an)h(indexed)e(arra)m(y)-8 b(.)150 +564 y Ft(printf)870 697 y(printf)46 b([-v)h Fj(var)p +Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])630 830 +y Fu(W)-8 b(rite)27 b(the)g(formatted)f Fr(argumen)m(ts)k +Fu(to)d(the)f(standard)f(output)h(under)e(the)i(con)m(trol)i(of)e(the) +630 939 y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g +(the)g(output)g(to)g(b)s(e)f(assigned)h(to)h(the)f(v)-5 +b(ariable)39 b Fr(v)-5 b(ar)630 1049 y Fu(rather)30 b(than)g(b)s(eing)g +(prin)m(ted)g(to)h(the)g(standard)e(output.)630 1181 +y(The)36 b Fr(format)i Fu(is)f(a)f(c)m(haracter)i(string)e(whic)m(h)g +(con)m(tains)i(three)e(t)m(yp)s(es)g(of)h(ob)5 b(jects:)53 +b(plain)630 1291 y(c)m(haracters,)41 b(whic)m(h)c(are)h(simply)e +(copied)i(to)g(standard)f(output,)i(c)m(haracter)g(escap)s(e)e(se-)630 +1401 y(quences,)g(whic)m(h)f(are)g(con)m(v)m(erted)h(and)f(copied)g(to) +g(the)g(standard)f(output,)i(and)f(format)630 1510 y(sp)s +(eci\014cations,)j(eac)m(h)e(of)g(whic)m(h)f(causes)g(prin)m(ting)g(of) +h(the)f(next)h(successiv)m(e)g Fr(argumen)m(t)p Fu(.)630 +1620 y(In)24 b(addition)h(to)g(the)g(standard)f Ft(printf\(1\))e +Fu(formats,)27 b Ft(printf)c Fu(in)m(terprets)i(the)f(follo)m(wing)630 +1729 y(extensions:)630 1885 y Ft(\045b)384 b Fu(Causes)38 +b Ft(printf)f Fu(to)j(expand)e(bac)m(kslash)h(escap)s(e)g(sequences)g +(in)f(the)h(cor-)1110 1995 y(resp)s(onding)31 b Fr(argumen)m(t)j +Fu(in)e(the)h(same)f(w)m(a)m(y)h(as)g Ft(echo)c(-e)j +Fu(\(see)h(Section)g(4.2)1110 2104 y([Bash)e(Builtins],)g(page)g(51\).) +630 2260 y Ft(\045q)384 b Fu(Causes)32 b Ft(printf)e +Fu(to)i(output)g(the)g(corresp)s(onding)f Fr(argumen)m(t)j +Fu(in)d(a)i(format)1110 2370 y(that)e(can)g(b)s(e)e(reused)h(as)h +(shell)f(input.)630 2525 y Ft(\045\()p Fj(datefmt)p Ft(\)T)1110 +2635 y Fu(Causes)f Ft(printf)e Fu(to)j(output)f(the)g(date-time)i +(string)e(resulting)h(from)e(using)1110 2744 y Fr(datefm)m(t)45 +b Fu(as)d(a)g(format)g(string)g(for)g Ft(strftime)p Fu(\(3\).)74 +b(The)41 b(corresp)s(onding)1110 2854 y Fr(argumen)m(t)h +Fu(is)e(an)g(in)m(teger)i(represen)m(ting)e(the)g(n)m(um)m(b)s(er)f(of) +h(seconds)g(since)1110 2964 y(the)24 b(ep)s(o)s(c)m(h.)38 +b(Tw)m(o)24 b(sp)s(ecial)h(argumen)m(t)f(v)-5 b(alues)24 +b(ma)m(y)h(b)s(e)e(used:)36 b(-1)25 b(represen)m(ts)1110 +3073 y(the)30 b(curren)m(t)g(time,)h(and)e(-2)i(represen)m(ts)f(the)g +(time)h(the)f(shell)g(w)m(as)g(in)m(v)m(ok)m(ed.)1110 +3183 y(If)38 b(no)g(argumen)m(t)h(is)f(sp)s(eci\014ed,)i(con)m(v)m (ersion)f(b)s(eha)m(v)m(es)g(as)g(if)f(-1)h(had)f(b)s(een)1110 -3051 y(giv)m(en.)k(This)29 b(is)i(an)f(exception)i(to)f(the)f(usual)g -Ft(printf)f Fu(b)s(eha)m(vior.)630 3213 y(The)d(\045b,)h(\045q,)h(and)e +3292 y(giv)m(en.)k(This)29 b(is)i(an)f(exception)i(to)f(the)f(usual)g +Ft(printf)f Fu(b)s(eha)m(vior.)630 3448 y(The)d(\045b,)h(\045q,)h(and)e (\045T)g(directiv)m(es)j(all)e(use)g(the)g(\014eld)f(width)g(and)h -(precision)g(argumen)m(ts)630 3322 y(from)f(the)g(format)h(sp)s +(precision)g(argumen)m(ts)630 3558 y(from)f(the)g(format)h(sp)s (eci\014cation)g(and)e(write)i(that)f(man)m(y)h(b)m(ytes)f(from)g(\(or) -h(use)e(that)i(wide)630 3432 y(a)42 b(\014eld)g(for\))g(the)h(expanded) +h(use)e(that)i(wide)630 3667 y(a)42 b(\014eld)g(for\))g(the)h(expanded) e(argumen)m(t,)k(whic)m(h)d(usually)g(con)m(tains)h(more)f(c)m -(haracters)630 3541 y(than)30 b(the)h(original.)630 3677 +(haracters)630 3777 y(than)30 b(the)h(original.)630 3910 y(Argumen)m(ts)d(to)h(non-string)e(format)i(sp)s(eci\014ers)e(are)h -(treated)h(as)g(C)e(language)j(constan)m(ts,)630 3786 +(treated)h(as)g(C)e(language)j(constan)m(ts,)630 4019 y(except)22 b(that)g(a)g(leading)g(plus)e(or)h(min)m(us)f(sign)i(is)f (allo)m(w)m(ed,)k(and)c(if)g(the)g(leading)h(c)m(haracter)h(is)630 -3896 y(a)i(single)g(or)f(double)h(quote,)h(the)f(v)-5 +4129 y(a)i(single)g(or)f(double)h(quote,)h(the)f(v)-5 b(alue)25 b(is)f(the)h(ASCI)s(I)e(v)-5 b(alue)25 b(of)f(the)h(follo)m -(wing)h(c)m(haracter.)630 4031 y(The)31 b Fr(format)i +(wing)h(c)m(haracter.)630 4261 y(The)31 b Fr(format)i Fu(is)f(reused)e(as)i(necessary)f(to)i(consume)e(all)h(of)f(the)h Fr(argumen)m(ts)p Fu(.)44 b(If)30 b(the)i Fr(for-)630 -4141 y(mat)c Fu(requires)e(more)g Fr(argumen)m(ts)k Fu(than)25 +4371 y(mat)c Fu(requires)e(more)g Fr(argumen)m(ts)k Fu(than)25 b(are)i(supplied,)e(the)h(extra)h(format)f(sp)s(eci\014cations)630 -4251 y(b)s(eha)m(v)m(e)j(as)g(if)f(a)h(zero)g(v)-5 b(alue)29 +4481 y(b)s(eha)m(v)m(e)j(as)g(if)f(a)h(zero)g(v)-5 b(alue)29 b(or)g(n)m(ull)f(string,)h(as)g(appropriate,)g(had)f(b)s(een)g -(supplied.)38 b(The)630 4360 y(return)29 b(v)-5 b(alue)31 +(supplied.)38 b(The)630 4590 y(return)29 b(v)-5 b(alue)31 b(is)g(zero)g(on)f(success,)h(non-zero)g(on)f(failure.)150 -4521 y Ft(read)870 4657 y(read)47 b([-ers])f([-a)h Fj(aname)p +4746 y Ft(read)870 4879 y(read)47 b([-ers])f([-a)h Fj(aname)p Ft(])f([-d)h Fj(delim)p Ft(])f([-i)h Fj(text)p Ft(])f([-n)h -Fj(nchars)p Ft(])1061 4766 y([-N)g Fj(nchars)p Ft(])f([-p)h +Fj(nchars)p Ft(])1061 4988 y([-N)g Fj(nchars)p Ft(])f([-p)h Fj(prompt)p Ft(])e([-t)i Fj(timeout)p Ft(])f([-u)h Fj(fd)p -Ft(])g([)p Fj(name)f Ft(...)o(])630 4902 y Fu(One)38 +Ft(])g([)p Fj(name)f Ft(...)o(])630 5121 y Fu(One)38 b(line)g(is)g(read)g(from)g(the)g(standard)f(input,)j(or)e(from)f(the)i -(\014le)f(descriptor)g Fr(fd)j Fu(sup-)630 5011 y(plied)34 +(\014le)f(descriptor)g Fr(fd)j Fu(sup-)630 5230 y(plied)34 b(as)h(an)f(argumen)m(t)h(to)g(the)f Ft(-u)g Fu(option,)i(split)f(in)m (to)g(w)m(ords)f(as)g(describ)s(ed)g(ab)s(o)m(v)m(e)h(in)630 -5121 y(Section)j(3.5.7)h([W)-8 b(ord)38 b(Splitting],)i(page)e(32,)j -(and)36 b(the)i(\014rst)f(w)m(ord)g(is)g(assigned)h(to)g(the)630 -5230 y(\014rst)32 b Fr(name)p Fu(,)h(the)g(second)g(w)m(ord)f(to)h(the) -g(second)g Fr(name)p Fu(,)g(and)f(so)h(on.)47 b(If)32 -b(there)h(are)g(more)630 5340 y(w)m(ords)39 b(than)g(names,)j(the)e -(remaining)f(w)m(ords)g(and)g(their)h(in)m(terv)m(ening)g(delimiters)h -(are)p eop end +5340 y(Section)j(3.5.7)h([W)-8 b(ord)38 b(Splitting],)i(page)e(32,)j +(and)36 b(the)i(\014rst)f(w)m(ord)g(is)g(assigned)h(to)g(the)p +eop end %%Page: 59 65 TeXDict begin 59 64 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(59)630 299 y(assigned)29 -b(to)h(the)g(last)g Fr(name)p Fu(.)40 b(If)29 b(there)g(are)h(few)m(er) -f(w)m(ords)g(read)g(from)g(the)g(input)g(stream)630 408 -y(than)35 b(names,)i(the)e(remaining)h(names)f(are)h(assigned)f(empt)m -(y)h(v)-5 b(alues.)56 b(The)34 b(c)m(haracters)630 518 -y(in)e(the)h(v)-5 b(alue)33 b(of)g(the)g Ft(IFS)f Fu(v)-5 -b(ariable)33 b(are)h(used)d(to)j(split)f(the)g(line)g(in)m(to)g(w)m -(ords)g(using)f(the)630 628 y(same)d(rules)f(the)g(shell)h(uses)f(for)g -(expansion)g(\(describ)s(ed)g(ab)s(o)m(v)m(e)i(in)e(Section)h(3.5.7)h -([W)-8 b(ord)630 737 y(Splitting],)38 b(page)f(32\).)60 +b(Shell)30 b(Builtin)h(Commands)2069 b(59)630 299 y(\014rst)32 +b Fr(name)p Fu(,)h(the)g(second)g(w)m(ord)f(to)h(the)g(second)g +Fr(name)p Fu(,)g(and)f(so)h(on.)47 b(If)32 b(there)h(are)g(more)630 +408 y(w)m(ords)39 b(than)g(names,)j(the)e(remaining)f(w)m(ords)g(and)g +(their)h(in)m(terv)m(ening)g(delimiters)h(are)630 518 +y(assigned)29 b(to)h(the)g(last)g Fr(name)p Fu(.)40 b(If)29 +b(there)g(are)h(few)m(er)f(w)m(ords)g(read)g(from)g(the)g(input)g +(stream)630 628 y(than)35 b(names,)i(the)e(remaining)h(names)f(are)h +(assigned)f(empt)m(y)h(v)-5 b(alues.)56 b(The)34 b(c)m(haracters)630 +737 y(in)e(the)h(v)-5 b(alue)33 b(of)g(the)g Ft(IFS)f +Fu(v)-5 b(ariable)33 b(are)h(used)d(to)j(split)f(the)g(line)g(in)m(to)g +(w)m(ords)g(using)f(the)630 847 y(same)d(rules)f(the)g(shell)h(uses)f +(for)g(expansion)g(\(describ)s(ed)g(ab)s(o)m(v)m(e)i(in)e(Section)h +(3.5.7)h([W)-8 b(ord)630 956 y(Splitting],)38 b(page)f(32\).)60 b(The)35 b(bac)m(kslash)i(c)m(haracter)h(`)p Ft(\\)p Fu(')e(ma)m(y)h(b)s(e)f(used)f(to)i(remo)m(v)m(e)h(an)m(y)630 -847 y(sp)s(ecial)i(meaning)g(for)f(the)g(next)h(c)m(haracter)h(read)e -(and)g(for)g(line)h(con)m(tin)m(uation.)69 b(If)39 b(no)630 -956 y(names)c(are)h(supplied,)f(the)h(line)g(read)f(is)g(assigned)h(to) -g(the)f(v)-5 b(ariable)36 b Ft(REPLY)p Fu(.)54 b(The)35 -b(exit)630 1066 y(status)f(is)f(zero,)i(unless)e(end-of-\014le)h(is)f -(encoun)m(tered,)i Ft(read)e Fu(times)h(out)f(\(in)h(whic)m(h)f(case) -630 1176 y(the)g(status)h(is)f(greater)i(than)e(128\),)j(a)e(v)-5 -b(ariable)34 b(assignmen)m(t)g(error)f(\(suc)m(h)g(as)g(assigning)630 -1285 y(to)38 b(a)f(readonly)g(v)-5 b(ariable\))38 b(o)s(ccurs,)h(or)e -(an)g(in)m(v)-5 b(alid)38 b(\014le)f(descriptor)g(is)g(supplied)e(as)j -(the)630 1395 y(argumen)m(t)31 b(to)g Ft(-u)p Fu(.)630 -1533 y(Options,)f(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo)m(wing)h -(meanings:)630 1700 y Ft(-a)e Fj(aname)114 b Fu(The)34 +1066 y(sp)s(ecial)31 b(meaning)g(for)f(the)g(next)h(c)m(haracter)h +(read)e(and)g(for)g(line)h(con)m(tin)m(uation.)630 1196 +y(Options,)f(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo)m(wing)h +(meanings:)630 1348 y Ft(-a)e Fj(aname)114 b Fu(The)34 b(w)m(ords)f(are)i(assigned)f(to)h(sequen)m(tial)h(indices)e(of)g(the)g -(arra)m(y)h(v)-5 b(ariable)1110 1810 y Fr(aname)p Fu(,)29 +(arra)m(y)h(v)-5 b(ariable)1110 1457 y Fr(aname)p Fu(,)29 b(starting)h(at)f(0.)40 b(All)29 b(elemen)m(ts)h(are)e(remo)m(v)m(ed)i -(from)d Fr(aname)34 b Fu(b)s(efore)1110 1920 y(the)d(assignmen)m(t.)41 +(from)d Fr(aname)34 b Fu(b)s(efore)1110 1567 y(the)d(assignmen)m(t.)41 b(Other)30 b Fr(name)36 b Fu(argumen)m(ts)30 b(are)h(ignored.)630 -2087 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f +1718 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f Fr(delim)g Fu(is)g(used)g(to)g(terminate)h(the)f(input)f(line,)1110 -2196 y(rather)31 b(than)g(newline.)42 b(If)30 b Fr(delim)h +1828 y(rather)31 b(than)g(newline.)42 b(If)30 b Fr(delim)h Fu(is)g(the)h(empt)m(y)f(string,)g Ft(read)f Fu(will)h(termi-)1110 -2306 y(nate)g(a)g(line)f(when)g(it)h(reads)f(a)h(NUL)f(c)m(haracter.) -630 2473 y Ft(-e)384 b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command) -f(Line)h(Editing],)50 b(page)45 b(111\))i(is)1110 2583 +1937 y(nate)g(a)g(line)f(when)g(it)h(reads)f(a)h(NUL)f(c)m(haracter.) +630 2089 y Ft(-e)384 b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command) +f(Line)h(Editing],)50 b(page)45 b(111\))i(is)1110 2198 y(used)37 b(to)i(obtain)g(the)f(line.)65 b(Readline)39 b(uses)e(the)i(curren)m(t)f(\(or)g(default,)j(if)1110 -2693 y(line)h(editing)g(w)m(as)g(not)g(previously)f(activ)m(e\))k -(editing)d(settings,)j(but)c(uses)1110 2802 y(Readline's)31 -b(default)g(\014lename)f(completion.)630 2969 y Ft(-i)g +2308 y(line)h(editing)g(w)m(as)g(not)g(previously)f(activ)m(e\))k +(editing)d(settings,)j(but)c(uses)1110 2418 y(Readline's)31 +b(default)g(\014lename)f(completion.)630 2569 y Ft(-i)g Fj(text)162 b Fu(If)36 b(Readline)i(is)f(b)s(eing)g(used)f(to)h(read)g (the)g(line,)j Fr(text)f Fu(is)e(placed)h(in)m(to)g(the)1110 -3079 y(editing)31 b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630 -3246 y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j +2679 y(editing)31 b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630 +2830 y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j (reading)f Fr(nc)m(hars)j Fu(c)m(haracters)e(rather)f(than)g(w)m -(aiting)1110 3356 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f -(honors)g(a)h(delimiter)g(if)f(few)m(er)h(than)1110 3465 +(aiting)1110 2939 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f +(honors)g(a)h(delimiter)g(if)f(few)m(er)h(than)1110 3049 y Fr(nc)m(hars)d Fu(c)m(haracters)e(are)e(read)h(b)s(efore)f(the)g -(delimiter.)630 3633 y Ft(-N)g Fj(nchars)66 b Ft(read)39 +(delimiter.)630 3200 y Ft(-N)g Fj(nchars)66 b Ft(read)39 b Fu(returns)f(after)j(reading)e(exactly)j Fr(nc)m(hars)h -Fu(c)m(haracters)f(rather)d(than)1110 3742 y(w)m(aiting)32 +Fu(c)m(haracters)f(rather)d(than)1110 3310 y(w)m(aiting)32 b(for)f(a)g(complete)i(line)e(of)g(input,)g(unless)f(EOF)h(is)g(encoun) -m(tered)g(or)1110 3852 y Ft(read)f Fu(times)i(out.)43 +m(tered)g(or)1110 3420 y Ft(read)f Fu(times)i(out.)43 b(Delimiter)33 b(c)m(haracters)f(encoun)m(tered)g(in)f(the)g(input)g -(are)1110 3961 y(not)g(treated)h(sp)s(ecially)f(and)f(do)h(not)g(cause) +(are)1110 3529 y(not)g(treated)h(sp)s(ecially)f(and)f(do)h(not)g(cause) g Ft(read)e Fu(to)j(return)d(un)m(til)i Fr(nc)m(hars)1110 -4071 y Fu(c)m(haracters)26 b(are)f(read.)38 b(The)24 +3639 y Fu(c)m(haracters)26 b(are)f(read.)38 b(The)24 b(result)g(is)h(not)f(split)h(on)f(the)h(c)m(haracters)h(in)e -Ft(IFS)p Fu(;)1110 4181 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5 +Ft(IFS)p Fu(;)1110 3748 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5 b(ariable)23 b(is)f(assigned)g(exactly)i(the)e(c)m(haracters)i(read) -1110 4290 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g -(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 4457 y +1110 3858 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g +(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 4009 y Ft(-p)f Fj(prompt)66 b Fu(Displa)m(y)38 b Fr(prompt)p Fu(,)g(without)e(a)h(trailing)h(newline,)h(b)s(efore)d(attempting)i(to) -1110 4567 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m -(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 4677 y(from)30 -b(a)h(terminal.)630 4844 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f +1110 4119 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m +(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 4228 y(from)30 +b(a)h(terminal.)630 4380 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f (giv)m(en,)k(bac)m(kslash)d(do)s(es)f(not)h(act)h(as)f(an)f(escap)s(e)h -(c)m(haracter.)1110 4954 y(The)30 b(bac)m(kslash)i(is)f(considered)g +(c)m(haracter.)1110 4489 y(The)30 b(bac)m(kslash)i(is)f(considered)g (to)h(b)s(e)e(part)h(of)g(the)g(line.)43 b(In)30 b(particular,)i(a)1110 -5063 y(bac)m(kslash-newline)26 b(pair)e(ma)m(y)h(not)g(then)g(b)s(e)f -(used)g(as)h(a)g(line)g(con)m(tin)m(uation.)630 5230 +4599 y(bac)m(kslash-newline)26 b(pair)e(ma)m(y)h(not)g(then)g(b)s(e)f +(used)g(as)h(a)g(line)g(con)m(tin)m(uation.)630 4750 y Ft(-s)384 b Fu(Silen)m(t)28 b(mo)s(de.)40 b(If)27 b(input)f(is)i (coming)g(from)f(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 -5340 y(ec)m(ho)s(ed.)p eop end +4860 y(ec)m(ho)s(ed.)630 5011 y Ft(-t)i Fj(timeout)1110 +5121 y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f +(failure)i(if)g(a)g(complete)h(line)f(of)1110 5230 y(input)26 +b(\(or)h(a)g(sp)s(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters\))h +(is)f(not)g(read)g(within)f Fr(time-)1110 5340 y(out)37 +b Fu(seconds.)53 b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h(decimal)h(n) +m(um)m(b)s(er)d(with)h(a)h(fractional)p eop end %%Page: 60 66 TeXDict begin 60 65 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(60)630 299 y Ft(-t)30 -b Fj(timeout)1110 408 y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f -(and)f(return)f(failure)i(if)g(a)g(complete)h(line)f(of)1110 -518 y(input)26 b(\(or)h(a)g(sp)s(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m -(haracters\))h(is)f(not)g(read)g(within)f Fr(time-)1110 -628 y(out)37 b Fu(seconds.)53 b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h -(decimal)h(n)m(um)m(b)s(er)d(with)h(a)h(fractional)1110 -737 y(p)s(ortion)29 b(follo)m(wing)h(the)f(decimal)h(p)s(oin)m(t.)40 -b(This)29 b(option)g(is)g(only)g(e\013ectiv)m(e)j(if)1110 -847 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h(terminal,)i(pip)s -(e,)e(or)g(other)f(sp)s(ecial)i(\014le;)1110 956 y(it)31 -b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g(\014les.)42 -b(If)30 b Ft(read)g Fu(times)h(out,)1110 1066 y Ft(read)d +b(Shell)30 b(Builtin)h(Commands)2069 b(60)1110 299 y(p)s(ortion)29 +b(follo)m(wing)h(the)f(decimal)h(p)s(oin)m(t.)40 b(This)29 +b(option)g(is)g(only)g(e\013ectiv)m(e)j(if)1110 408 y +Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h(terminal,)i(pip)s(e,)e +(or)g(other)f(sp)s(ecial)i(\014le;)1110 518 y(it)31 b(has)g(no)g +(e\013ect)h(when)e(reading)h(from)g(regular)g(\014les.)42 +b(If)30 b Ft(read)g Fu(times)h(out,)1110 628 y Ft(read)d Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)m(to)h(the)e(sp)s (eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p Fu(.)1110 -1176 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e Fu(returns)f +737 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e Fu(returns)f (immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110 -1285 y(an)m(y)c(data.)44 b(The)31 b(exit)h(status)f(is)h(0)f(if)h -(input)e(is)h(a)m(v)-5 b(ailable)34 b(on)d(the)h(sp)s(eci\014ed)1110 -1395 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46 -b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 1504 -y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 1656 +847 y(an)m(y)c(data.)44 b(The)31 b(exit)h(status)f(is)h(0)f(if)h(input) +e(is)h(a)m(v)-5 b(ailable)34 b(on)d(the)h(sp)s(eci\014ed)1110 +956 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46 +b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 1066 +y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 1225 y Ft(-u)g Fj(fd)258 b Fu(Read)31 b(input)e(from)h(\014le)g(descriptor)h -Fr(fd)p Fu(.)150 1807 y Ft(readarray)870 1917 y(readarray)45 -b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p Ft(])f([-O)h -Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])1061 2026 y([-t])g([-u)f -Fj(fd)p Ft(])h([-C)g Fj(callback)p Ft(])f([-c)g Fj(quantum)p -Ft(])g([)p Fj(array)p Ft(])630 2157 y Fu(Read)38 b(lines)f(from)g(the)h -(standard)e(input)g(in)m(to)j(the)e(indexed)g(arra)m(y)h(v)-5 -b(ariable)38 b Fr(arra)m(y)p Fu(,)i(or)630 2266 y(from)30 -b(\014le)g(descriptor)h Fr(fd)i Fu(if)d(the)h Ft(-u)e -Fu(option)i(is)g(supplied.)630 2397 y(A)f(synon)m(ym)g(for)g -Ft(mapfile)p Fu(.)150 2548 y Ft(source)870 2679 y(source)46 -b Fj(filename)630 2809 y Fu(A)30 b(synon)m(ym)g(for)g -Ft(.)g Fu(\(see)i(Section)f(4.1)g([Bourne)g(Shell)f(Builtins],)h(page)g -(44\).)150 2960 y Ft(type)870 3091 y(type)47 b([-afptP])e([)p -Fj(name)i Ft(...)o(])630 3221 y Fu(F)-8 b(or)42 b(eac)m(h)g -Fr(name)p Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m -(terpreted)g(if)g(used)f(as)i(a)f(command)630 3331 y(name.)630 -3461 y(If)g(the)g Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c -Fu(prin)m(ts)h(a)h(single)g(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p -Ft(alias)p Fu(',)630 3571 y(`)p Ft(function)p Fu(',)32 -b(`)p Ft(builtin)p Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p -Ft(keyword)p Fu(',)f(if)h Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e -(function,)630 3680 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h -(reserv)m(ed)g(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55 -b(If)34 b(the)h Fr(name)40 b Fu(is)35 b(not)630 3790 -y(found,)29 b(then)h(nothing)h(is)f(prin)m(ted,)g(and)g -Ft(type)f Fu(returns)g(a)i(failure)g(status.)630 3921 -y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h Ft(type)e -Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g(that)h(w) -m(ould)630 4030 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g +Fr(fd)p Fu(.)630 1385 y(If)h(no)g Fr(name)5 b Fu(s)33 +b(are)f(supplied,)g(the)h(line)g(read,)g(without)f(the)h(ending)f +(delimiter)h(but)e(oth-)630 1494 y(erwise)36 b(unmo)s(di\014ed,)e(is)i +(assigned)f(to)h(the)g(v)-5 b(ariable)36 b Ft(REPLY)p +Fu(.)55 b(The)34 b(exit)j(status)e(is)h(zero,)630 1604 +y(unless)i(end-of-\014le)h(is)f(encoun)m(tered,)j Ft(read)d +Fu(times)h(out)f(\(in)h(whic)m(h)f(case)h(the)g(status)g(is)630 +1714 y(greater)31 b(than)f(128\),)i(a)e(v)-5 b(ariable)30 +b(assignmen)m(t)h(error)f(\(suc)m(h)f(as)i(assigning)f(to)h(a)f +(readonly)630 1823 y(v)-5 b(ariable\))30 b(o)s(ccurs,)f(or)f(an)h(in)m +(v)-5 b(alid)29 b(\014le)g(descriptor)f(is)h(supplied)e(as)i(the)g +(argumen)m(t)g(to)g Ft(-u)p Fu(.)150 1983 y Ft(readarray)870 +2092 y(readarray)45 b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p +Ft(])f([-O)h Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])1061 +2202 y([-t])g([-u)f Fj(fd)p Ft(])h([-C)g Fj(callback)p +Ft(])f([-c)g Fj(quantum)p Ft(])g([)p Fj(array)p Ft(])630 +2336 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j +(the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38 b Fr(arra)m(y)p +Fu(,)i(or)630 2446 y(from)30 b(\014le)g(descriptor)h +Fr(fd)i Fu(if)d(the)h Ft(-u)e Fu(option)i(is)g(supplied.)630 +2580 y(A)f(synon)m(ym)g(for)g Ft(mapfile)p Fu(.)150 2740 +y Ft(source)870 2874 y(source)46 b Fj(filename)630 3009 +y Fu(A)30 b(synon)m(ym)g(for)g Ft(.)g Fu(\(see)i(Section)f(4.1)g +([Bourne)g(Shell)f(Builtins],)h(page)g(44\).)150 3168 +y Ft(type)870 3303 y(type)47 b([-afptP])e([)p Fj(name)i +Ft(...)o(])630 3437 y Fu(F)-8 b(or)42 b(eac)m(h)g Fr(name)p +Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m(terpreted)g(if) +g(used)f(as)i(a)f(command)630 3547 y(name.)630 3681 y(If)g(the)g +Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c Fu(prin)m(ts)h(a)h(single)g +(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p Ft(alias)p +Fu(',)630 3791 y(`)p Ft(function)p Fu(',)32 b(`)p Ft(builtin)p +Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p Ft(keyword)p Fu(',)f(if)h +Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e(function,)630 +3900 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h(reserv)m(ed)g +(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55 b(If)34 b(the)h +Fr(name)40 b Fu(is)35 b(not)630 4010 y(found,)29 b(then)h(nothing)h(is) +f(prin)m(ted,)g(and)g Ft(type)f Fu(returns)g(a)i(failure)g(status.)630 +4144 y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h +Ft(type)e Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g +(that)h(w)m(ould)630 4254 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g Ft(-t)g Fu(w)m(ould)g(not)h(return)e(`)p Ft(file)p Fu('.)630 -4161 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g +4389 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g (eac)m(h)g Fr(name)p Fu(,)g(ev)m(en)g(if)g Ft(-t)f Fu(w)m(ould)g(not)h -(return)630 4270 y(`)p Ft(file)p Fu('.)630 4401 y(If)f(a)g(command)g +(return)630 4498 y(`)p Ft(file)p Fu('.)630 4633 y(If)f(a)g(command)g (is)g(hashed,)f Ft(-p)h Fu(and)f Ft(-P)g Fu(prin)m(t)h(the)g(hashed)f -(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 4510 +(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 4742 y(sarily)h(the)f(\014le)h(that)g(app)s(ears)e(\014rst)h(in)g -Ft($PATH)p Fu(.)630 4641 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g +Ft($PATH)p Fu(.)630 4877 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g (used,)h Ft(type)e Fu(returns)f(all)j(of)f(the)g(places)h(that)f(con)m -(tain)i(an)d(executable)630 4750 y(named)32 b Fr(\014le)p +(tain)i(an)d(executable)630 4986 y(named)32 b Fr(\014le)p Fu(.)49 b(This)32 b(includes)h(aliases)h(and)e(functions,)i(if)f(and)f -(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 4860 y(not)d(also)g -(used.)630 4990 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e +(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 5096 y(not)d(also)g +(used.)630 5230 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e Ft(type)g Fu(do)s(es)h(not)h(attempt)g(to)g(\014nd)d(shell)j -(functions,)f(as)g(with)630 5100 y(the)h Ft(command)d -Fu(builtin.)630 5230 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h -(of)f(the)h Fr(names)i Fu(are)e(found,)e(non-zero)i(if)f(an)m(y)g(are)h -(not)630 5340 y(found.)p eop end +(functions,)f(as)g(with)630 5340 y(the)h Ft(command)d +Fu(builtin.)p eop end %%Page: 61 67 TeXDict begin 61 66 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(61)150 299 y Ft(typeset)870 -432 y(typeset)46 b([-afFgrxilnrtux])d([-p])k([)p Fj(name)p -Ft([=)p Fj(value)p Ft(])d(...)o(])630 564 y Fu(The)31 -b Ft(typeset)e Fu(command)i(is)g(supplied)f(for)h(compatibilit)m(y)i -(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 674 y(a)g(synon)m(ym)f -(for)g(the)g Ft(declare)f Fu(builtin)h(command.)150 830 -y Ft(ulimit)870 963 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c([)p -Fj(limit)p Ft(])630 1096 y(ulimit)25 b Fu(pro)m(vides)h(con)m(trol)i(o) -m(v)m(er)g(the)f(resources)f(a)m(v)-5 b(ailable)29 b(to)e(pro)s(cesses) -f(started)h(b)m(y)g(the)630 1205 y(shell,)i(on)f(systems)g(that)h(allo) -m(w)h(suc)m(h)e(con)m(trol.)41 b(If)28 b(an)g(option)h(is)f(giv)m(en,)i -(it)e(is)h(in)m(terpreted)630 1315 y(as)i(follo)m(ws:)630 -1471 y Ft(-S)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the)g(soft)h(limit) -g(asso)s(ciated)h(with)e(a)h(resource.)630 1627 y Ft(-H)384 -b Fu(Change)30 b(and)g(rep)s(ort)g(the)g(hard)g(limit)h(asso)s(ciated)h -(with)e(a)h(resource.)630 1783 y Ft(-a)384 b Fu(All)31 -b(curren)m(t)f(limits)h(are)g(rep)s(orted.)630 1938 y -Ft(-b)384 b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e -(size.)630 2094 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g -(core)g(\014les)f(created.)630 2250 y Ft(-d)384 b Fu(The)30 -b(maxim)m(um)g(size)h(of)g(a)g(pro)s(cess's)f(data)h(segmen)m(t.)630 -2406 y Ft(-e)384 b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m -(y)f(\()p Ft(")p Fu(nice)p Ft(")p Fu(\).)630 2562 y Ft(-f)384 -b Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the) -g(shell)h(and)f(its)h(c)m(hildren.)630 2718 y Ft(-i)384 +b(Shell)30 b(Builtin)h(Commands)2069 b(61)630 299 y(The)31 +b(return)f(status)h(is)g(zero)h(if)f(all)h(of)f(the)h +Fr(names)i Fu(are)e(found,)e(non-zero)i(if)f(an)m(y)g(are)h(not)630 +408 y(found.)150 571 y Ft(typeset)870 707 y(typeset)46 +b([-afFgrxilnrtux])d([-p])k([)p Fj(name)p Ft([=)p Fj(value)p +Ft(])d(...)o(])630 842 y Fu(The)31 b Ft(typeset)e Fu(command)i(is)g +(supplied)f(for)h(compatibilit)m(y)i(with)e(the)g(Korn)f(shell.)44 +b(It)31 b(is)630 952 y(a)g(synon)m(ym)f(for)g(the)g Ft(declare)f +Fu(builtin)h(command.)150 1114 y Ft(ulimit)870 1250 y(ulimit)46 +b([-HSabcdefiklmnpqrstuvxPT)o(])c([)p Fj(limit)p Ft(])630 +1386 y(ulimit)25 b Fu(pro)m(vides)h(con)m(trol)i(o)m(v)m(er)g(the)f +(resources)f(a)m(v)-5 b(ailable)29 b(to)e(pro)s(cesses)f(started)h(b)m +(y)g(the)630 1496 y(shell,)i(on)f(systems)g(that)h(allo)m(w)h(suc)m(h)e +(con)m(trol.)41 b(If)28 b(an)g(option)h(is)f(giv)m(en,)i(it)e(is)h(in)m +(terpreted)630 1605 y(as)i(follo)m(ws:)630 1767 y Ft(-S)384 +b Fu(Change)30 b(and)g(rep)s(ort)g(the)g(soft)h(limit)g(asso)s(ciated)h +(with)e(a)h(resource.)630 1930 y Ft(-H)384 b Fu(Change)30 +b(and)g(rep)s(ort)g(the)g(hard)g(limit)h(asso)s(ciated)h(with)e(a)h +(resource.)630 2092 y Ft(-a)384 b Fu(All)31 b(curren)m(t)f(limits)h +(are)g(rep)s(orted.)630 2254 y Ft(-b)384 b Fu(The)30 +b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e(size.)630 +2416 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(core)g(\014les) +f(created.)630 2578 y Ft(-d)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g +(a)g(pro)s(cess's)f(data)h(segmen)m(t.)630 2741 y Ft(-e)384 +b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m(y)f(\()p +Ft(")p Fu(nice)p Ft(")p Fu(\).)630 2903 y Ft(-f)384 b +Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the)g +(shell)h(and)f(its)h(c)m(hildren.)630 3065 y Ft(-i)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(p)s(ending)e -(signals.)630 2874 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s +(signals.)630 3227 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s (er)f(of)i(kqueues)f(that)h(ma)m(y)g(b)s(e)e(allo)s(cated.)630 -3030 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s -(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 3186 +3389 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s +(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 3551 y Ft(-m)384 b Fu(The)36 b(maxim)m(um)g(residen)m(t)h(set)g(size)g -(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 3296 -y(limit\).)630 3452 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s +(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 3661 +y(limit\).)630 3823 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s (er)e(of)i(op)s(en)f(\014le)h(descriptors)g(\(most)g(systems)g(do)1110 -3561 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).) -630 3717 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630 -3873 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m -(ytes)g(in)f Fm(posix)f Fu(message)j(queues.)630 4029 +3933 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).) +630 4095 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630 +4257 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m +(ytes)g(in)f Fm(posix)f Fu(message)j(queues.)630 4419 y Ft(-r)384 b Fu(The)30 b(maxim)m(um)g(real-time)i(sc)m(heduling)f -(priorit)m(y)-8 b(.)630 4185 y Ft(-s)384 b Fu(The)30 -b(maxim)m(um)g(stac)m(k)i(size.)630 4341 y Ft(-t)384 +(priorit)m(y)-8 b(.)630 4582 y Ft(-s)384 b Fu(The)30 +b(maxim)m(um)g(stac)m(k)i(size.)630 4744 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g(time)h(in)f(seconds.) -630 4497 y Ft(-u)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i +630 4906 y Ft(-u)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i (pro)s(cesses)f(a)m(v)-5 b(ailable)33 b(to)e(a)f(single)i(user.)630 -4653 y Ft(-v)384 b Fu(The)41 b(maxim)m(um)h(amoun)m(t)g(of)h(virtual)f +5068 y Ft(-v)384 b Fu(The)41 b(maxim)m(um)h(amoun)m(t)g(of)h(virtual)f (memory)g(a)m(v)-5 b(ailable)44 b(to)e(the)g(shell,)1110 -4763 y(and,)30 b(on)g(some)h(systems,)g(to)g(its)g(c)m(hildren.)630 -4918 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i -(\014le)f(lo)s(c)m(ks.)630 5074 y Ft(-P)384 b Fu(The)30 -b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pseudoterminals.)630 -5230 y Ft(-R)384 b Fu(The)27 b(maxim)m(um)h(time)h(a)f(real-time)i(pro) -s(cess)d(can)i(run)d(b)s(efore)i(blo)s(c)m(king,)h(in)1110 -5340 y(microseconds.)p eop end +5178 y(and,)30 b(on)g(some)h(systems,)g(to)g(its)g(c)m(hildren.)630 +5340 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i +(\014le)f(lo)s(c)m(ks.)p eop end %%Page: 62 68 TeXDict begin 62 67 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(62)630 299 y Ft(-T)384 -b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(threads.)630 -451 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h -Ft(-a)f Fu(option)h(is)f(not)h(used,)h Fr(limit)h Fu(is)e(the)g(new)f -(v)-5 b(alue)37 b(of)g(the)630 561 y(sp)s(eci\014ed)c(resource.)51 -b(The)34 b(sp)s(ecial)g Fr(limit)j Fu(v)-5 b(alues)34 -b Ft(hard)p Fu(,)g Ft(soft)p Fu(,)g(and)f Ft(unlimited)e -Fu(stand)630 670 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g -(curren)m(t)f(soft)g(limit,)h(and)f(no)g(limit,)h(resp)s(ectiv)m(ely)-8 -b(.)48 b(A)630 780 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b)m -(y)f(a)h(non-ro)s(ot)g(user)f(once)i(it)f(is)g(set;)k(a)c(soft)g(limit) -630 890 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5 -b(alue)40 b(of)g(the)h(hard)e(limit.)70 b(Otherwise,)43 -b(the)d(curren)m(t)630 999 y(v)-5 b(alue)29 b(of)h(the)f(soft)g(limit)h -(for)e(the)h(sp)s(eci\014ed)g(resource)g(is)g(prin)m(ted,)g(unless)f -(the)h Ft(-H)f Fu(option)630 1109 y(is)h(supplied.)39 -b(When)29 b(setting)h(new)f(limits,)h(if)f(neither)g -Ft(-H)g Fu(nor)f Ft(-S)h Fu(is)g(supplied,)f(b)s(oth)h(the)630 -1218 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 b(If)31 -b(no)i(option)f(is)h(giv)m(en,)h(then)e Ft(-f)g Fu(is)g(assumed.)46 -b(V)-8 b(alues)630 1328 y(are)38 b(in)g(1024-b)m(yte)i(incremen)m(ts,)g -(except)f(for)f Ft(-t)p Fu(,)h(whic)m(h)e(is)h(in)g(seconds;)j -Ft(-R)p Fu(,)e(whic)m(h)f(is)630 1438 y(in)g(microseconds;)43 +b(Shell)30 b(Builtin)h(Commands)2069 b(62)630 299 y Ft(-P)384 +b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pseudoterminals.)630 +462 y Ft(-R)384 b Fu(The)27 b(maxim)m(um)h(time)h(a)f(real-time)i(pro)s +(cess)d(can)i(run)d(b)s(efore)i(blo)s(c)m(king,)h(in)1110 +571 y(microseconds.)630 734 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m +(um)m(b)s(er)f(of)i(threads.)630 896 y(If)36 b Fr(limit)k +Fu(is)c(giv)m(en,)k(and)c(the)h Ft(-a)f Fu(option)h(is)f(not)h(used,)h +Fr(limit)h Fu(is)e(the)g(new)f(v)-5 b(alue)37 b(of)g(the)630 +1006 y(sp)s(eci\014ed)c(resource.)51 b(The)34 b(sp)s(ecial)g +Fr(limit)j Fu(v)-5 b(alues)34 b Ft(hard)p Fu(,)g Ft(soft)p +Fu(,)g(and)f Ft(unlimited)e Fu(stand)630 1116 y(for)h(the)g(curren)m(t) +g(hard)f(limit,)i(the)g(curren)m(t)f(soft)g(limit,)h(and)f(no)g(limit,) +h(resp)s(ectiv)m(ely)-8 b(.)48 b(A)630 1225 y(hard)37 +b(limit)h(cannot)h(b)s(e)e(increased)h(b)m(y)f(a)h(non-ro)s(ot)g(user)f +(once)i(it)f(is)g(set;)k(a)c(soft)g(limit)630 1335 y(ma)m(y)j(b)s(e)e +(increased)i(up)e(to)h(the)h(v)-5 b(alue)40 b(of)g(the)h(hard)e(limit.) +70 b(Otherwise,)43 b(the)d(curren)m(t)630 1444 y(v)-5 +b(alue)29 b(of)h(the)f(soft)g(limit)h(for)e(the)h(sp)s(eci\014ed)g +(resource)g(is)g(prin)m(ted,)g(unless)f(the)h Ft(-H)f +Fu(option)630 1554 y(is)h(supplied.)39 b(When)29 b(setting)h(new)f +(limits,)h(if)f(neither)g Ft(-H)g Fu(nor)f Ft(-S)h Fu(is)g(supplied,)f +(b)s(oth)h(the)630 1664 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 +b(If)31 b(no)i(option)f(is)h(giv)m(en,)h(then)e Ft(-f)g +Fu(is)g(assumed.)46 b(V)-8 b(alues)630 1773 y(are)38 +b(in)g(1024-b)m(yte)i(incremen)m(ts,)g(except)f(for)f +Ft(-t)p Fu(,)h(whic)m(h)e(is)h(in)g(seconds;)j Ft(-R)p +Fu(,)e(whic)m(h)f(is)630 1883 y(in)g(microseconds;)43 b Ft(-p)p Fu(,)d(whic)m(h)e(is)g(in)g(units)f(of)i(512-b)m(yte)h(blo)s (c)m(ks;)j Ft(-P)p Fu(,)d Ft(-T)p Fu(,)g Ft(-b)p Fu(,)g -Ft(-k)p Fu(,)g Ft(-n)630 1547 y Fu(and)29 b Ft(-u)p Fu(,)h(whic)m(h)f +Ft(-k)p Fu(,)g Ft(-n)630 1992 y Fu(and)29 b Ft(-u)p Fu(,)h(whic)m(h)f (are)h(unscaled)f(v)-5 b(alues;)31 b(and,)e(when)g(in)h -Fm(posix)e Fu(Mo)s(de)i(\(see)h(Section)f(6.11)630 1657 +Fm(posix)e Fu(Mo)s(de)i(\(see)h(Section)f(6.11)630 2102 y([Bash)h(POSIX)e(Mo)s(de],)i(page)g(101\),)i Ft(-c)c Fu(and)h Ft(-f)p Fu(,)g(whic)m(h)g(are)h(in)f(512-b)m(yte)j(incremen)m -(ts.)630 1788 y(The)h(return)g(status)h(is)f(zero)i(unless)e(an)g(in)m +(ts.)630 2238 y(The)h(return)g(status)h(is)f(zero)i(unless)e(an)g(in)m (v)-5 b(alid)36 b(option)f(or)f(argumen)m(t)i(is)e(supplied,)h(or)630 -1897 y(an)30 b(error)g(o)s(ccurs)g(while)h(setting)g(a)g(new)f(limit.) -150 2050 y Ft(unalias)870 2181 y(unalias)46 b([-a])g([)p -Fj(name)h Ft(...)g(])630 2312 y Fu(Remo)m(v)m(e)42 b(eac)m(h)f +2348 y(an)30 b(error)g(o)s(ccurs)g(while)h(setting)g(a)g(new)f(limit.) +150 2510 y Ft(unalias)870 2646 y(unalias)46 b([-a])g([)p +Fj(name)h Ft(...)g(])630 2782 y Fu(Remo)m(v)m(e)42 b(eac)m(h)f Fr(name)k Fu(from)39 b(the)i(list)f(of)g(aliases.)71 b(If)40 b Ft(-a)f Fu(is)h(supplied,)h(all)g(aliases)h(are)630 -2421 y(remo)m(v)m(ed.)g(Aliases)31 b(are)g(describ)s(ed)e(in)h(Section) -i(6.6)f([Aliases],)h(page)f(94.)150 2655 y Fs(4.3)68 -b(Mo)t(difying)45 b(Shell)g(Beha)l(vior)150 2876 y Fk(4.3.1)63 -b(The)41 b(Set)g(Builtin)150 3023 y Fu(This)35 b(builtin)h(is)g(so)g +2892 y(remo)m(v)m(ed.)g(Aliases)31 b(are)g(describ)s(ed)e(in)h(Section) +i(6.6)f([Aliases],)h(page)f(94.)150 3138 y Fs(4.3)68 +b(Mo)t(difying)45 b(Shell)g(Beha)l(vior)150 3362 y Fk(4.3.1)63 +b(The)41 b(Set)g(Builtin)150 3509 y Fu(This)35 b(builtin)h(is)g(so)g (complicated)i(that)f(it)f(deserv)m(es)h(its)f(o)m(wn)g(section.)59 b Ft(set)35 b Fu(allo)m(ws)j(y)m(ou)e(to)h(c)m(hange)150 -3132 y(the)c(v)-5 b(alues)34 b(of)f(shell)g(options)h(and)e(set)i(the)f +3618 y(the)c(v)-5 b(alues)34 b(of)f(shell)g(options)h(and)e(set)i(the)f (p)s(ositional)h(parameters,)h(or)e(to)h(displa)m(y)f(the)g(names)h -(and)150 3242 y(v)-5 b(alues)31 b(of)f(shell)h(v)-5 b(ariables.)150 -3394 y Ft(set)870 3525 y(set)47 b([--abefhkmnptuvxBCEHPT])41 +(and)150 3728 y(v)-5 b(alues)31 b(of)f(shell)h(v)-5 b(ariables.)150 +3892 y Ft(set)870 4028 y(set)47 b([--abefhkmnptuvxBCEHPT])41 b([-o)47 b Fj(option-name)p Ft(])e([)p Fj(argument)g -Ft(...)o(])870 3635 y(set)i([+abefhkmnptuvxBCEHPT])42 +Ft(...)o(])870 4138 y(set)i([+abefhkmnptuvxBCEHPT])42 b([+o)47 b Fj(option-name)p Ft(])d([)p Fj(argument)h -Ft(...)o(])630 3766 y Fu(If)22 b(no)h(options)g(or)g(argumen)m(ts)g +Ft(...)o(])630 4274 y Fu(If)22 b(no)h(options)g(or)g(argumen)m(ts)g (are)g(supplied,)g Ft(set)f Fu(displa)m(ys)g(the)h(names)g(and)f(v)-5 -b(alues)23 b(of)g(all)630 3875 y(shell)j(v)-5 b(ariables)27 +b(alues)23 b(of)g(all)630 4384 y(shell)j(v)-5 b(ariables)27 b(and)e(functions,)h(sorted)g(according)h(to)g(the)f(curren)m(t)f(lo)s -(cale,)k(in)c(a)i(format)630 3985 y(that)i(ma)m(y)h(b)s(e)e(reused)g +(cale,)k(in)c(a)i(format)630 4493 y(that)i(ma)m(y)h(b)s(e)e(reused)g (as)h(input)f(for)h(setting)h(or)e(resetting)i(the)f(curren)m(tly-set)h -(v)-5 b(ariables.)630 4094 y(Read-only)37 b(v)-5 b(ariables)37 +(v)-5 b(ariables.)630 4603 y(Read-only)37 b(v)-5 b(ariables)37 b(cannot)h(b)s(e)e(reset.)59 b(In)36 b Fm(posix)g Fu(mo)s(de,)i(only)f -(shell)f(v)-5 b(ariables)38 b(are)630 4204 y(listed.)630 -4335 y(When)29 b(options)g(are)g(supplied,)f(they)h(set)h(or)f(unset)f +(shell)f(v)-5 b(ariables)38 b(are)630 4712 y(listed.)630 +4849 y(When)29 b(options)g(are)g(supplied,)f(they)h(set)h(or)f(unset)f (shell)h(attributes.)41 b(Options,)29 b(if)g(sp)s(ec-)630 -4445 y(i\014ed,)h(ha)m(v)m(e)i(the)e(follo)m(wing)i(meanings:)630 -4597 y Ft(-a)384 b Fu(Eac)m(h)37 b(v)-5 b(ariable)36 +4958 y(i\014ed,)h(ha)m(v)m(e)i(the)e(follo)m(wing)i(meanings:)630 +5121 y Ft(-a)384 b Fu(Eac)m(h)37 b(v)-5 b(ariable)36 b(or)g(function)g(that)g(is)g(created)h(or)f(mo)s(di\014ed)f(is)h(giv)m -(en)h(the)1110 4706 y(exp)s(ort)28 b(attribute)h(and)f(mark)m(ed)g(for) +(en)h(the)1110 5230 y(exp)s(ort)28 b(attribute)h(and)f(mark)m(ed)g(for) g(exp)s(ort)g(to)h(the)g(en)m(vironmen)m(t)f(of)h(sub-)1110 -4816 y(sequen)m(t)i(commands.)630 4968 y Ft(-b)384 b -Fu(Cause)44 b(the)h(status)g(of)f(terminated)h(bac)m(kground)g(jobs)f -(to)h(b)s(e)f(rep)s(orted)1110 5078 y(immediately)-8 -b(,)30 b(rather)d(than)f(b)s(efore)h(prin)m(ting)g(the)g(next)g -(primary)g(prompt.)630 5230 y Ft(-e)384 b Fu(Exit)65 -b(immediately)g(if)f(a)h(pip)s(eline)e(\(see)i(Section)g(3.2.3)h([Pip)s -(elines],)1110 5340 y(page)56 b(8\),)62 b(whic)m(h)55 -b(ma)m(y)h(consist)f(of)h(a)f(single)h(simple)f(command)g(\(see)p -eop end +5340 y(sequen)m(t)i(commands.)p eop end %%Page: 63 69 TeXDict begin 63 68 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(63)1110 299 y(Section)30 +b(Shell)30 b(Builtin)h(Commands)2069 b(63)630 299 y Ft(-b)384 +b Fu(Cause)44 b(the)h(status)g(of)f(terminated)h(bac)m(kground)g(jobs)f +(to)h(b)s(e)f(rep)s(orted)1110 408 y(immediately)-8 b(,)30 +b(rather)d(than)f(b)s(efore)h(prin)m(ting)g(the)g(next)g(primary)g +(prompt.)630 555 y Ft(-e)384 b Fu(Exit)65 b(immediately)g(if)f(a)h(pip) +s(eline)e(\(see)i(Section)g(3.2.3)h([Pip)s(elines],)1110 +664 y(page)56 b(8\),)62 b(whic)m(h)55 b(ma)m(y)h(consist)f(of)h(a)f +(single)h(simple)f(command)g(\(see)1110 774 y(Section)30 b(3.2.2)i([Simple)d(Commands],)g(page)h(8\),)h(a)f(list)g(\(see)h -(Section)f(3.2.4)1110 408 y([Lists],)66 b(page)59 b(9\),)67 +(Section)f(3.2.4)1110 883 y([Lists],)66 b(page)59 b(9\),)67 b(or)58 b(a)h(comp)s(ound)e(command)h(\(see)h(Section)g(3.2.5)1110 -518 y([Comp)s(ound)h(Commands],)70 b(page)63 b(10\))g(returns)e(a)i -(non-zero)f(status.)1110 628 y(The)41 b(shell)g(do)s(es)g(not)g(exit)h +993 y([Comp)s(ound)h(Commands],)70 b(page)63 b(10\))g(returns)e(a)i +(non-zero)f(status.)1110 1103 y(The)41 b(shell)g(do)s(es)g(not)g(exit)h (if)f(the)h(command)f(that)h(fails)f(is)g(part)g(of)h(the)1110 -737 y(command)g(list)h(immediately)g(follo)m(wing)g(a)g +1212 y(command)g(list)h(immediately)g(follo)m(wing)g(a)g Ft(while)e Fu(or)h Ft(until)e Fu(k)m(eyw)m(ord,)1110 -847 y(part)61 b(of)g(the)g(test)h(in)e(an)h Ft(if)f Fu(statemen)m(t,)71 -b(part)61 b(of)g(an)m(y)g(command)1110 956 y(executed)50 -b(in)e(a)h Ft(&&)f Fu(or)h Ft(||)f Fu(list)h(except)g(the)g(command)g -(follo)m(wing)h(the)1110 1066 y(\014nal)37 b Ft(&&)g -Fu(or)g Ft(||)p Fu(,)h(an)m(y)g(command)f(in)g(a)g(pip)s(eline)g(but)g -(the)g(last,)j(or)e(if)f(the)1110 1176 y(command's)c(return)f(status)h -(is)g(b)s(eing)g(in)m(v)m(erted)h(with)e Ft(!)p Fu(.)48 -b(If)33 b(a)g(comp)s(ound)1110 1285 y(command)g(other)g(than)f(a)i -(subshell)d(returns)h(a)h(non-zero)h(status)f(b)s(ecause)1110 -1395 y(a)k(command)g(failed)g(while)g Ft(-e)f Fu(w)m(as)i(b)s(eing)e -(ignored,)j(the)e(shell)g(do)s(es)g(not)1110 1504 y(exit.)42 -b(A)30 b(trap)g(on)h Ft(ERR)p Fu(,)e(if)i(set,)g(is)f(executed)i(b)s -(efore)e(the)g(shell)h(exits.)1110 1644 y(This)f(option)h(applies)f(to) -h(the)g(shell)g(en)m(vironmen)m(t)g(and)f(eac)m(h)h(subshell)f(en-)1110 -1754 y(vironmen)m(t)j(separately)i(\(see)f(Section)g(3.7.3)h([Command)d -(Execution)i(En-)1110 1864 y(vironmen)m(t],)i(page)f(40\),)i(and)d(ma)m -(y)h(cause)f(subshells)g(to)h(exit)g(b)s(efore)f(exe-)1110 -1973 y(cuting)d(all)g(the)g(commands)f(in)g(the)g(subshell.)1110 -2113 y(If)41 b(a)g(comp)s(ound)e(command)i(or)g(shell)g(function)g -(executes)h(in)f(a)g(con)m(text)1110 2223 y(where)31 -b Ft(-e)g Fu(is)g(b)s(eing)g(ignored,)h(none)f(of)h(the)f(commands)g -(executed)h(within)1110 2332 y(the)j(comp)s(ound)f(command)h(or)g -(function)f(b)s(o)s(dy)g(will)h(b)s(e)f(a\013ected)j(b)m(y)e(the)1110 -2442 y Ft(-e)25 b Fu(setting,)j(ev)m(en)e(if)g Ft(-e)f -Fu(is)h(set)g(and)f(a)h(command)g(returns)e(a)i(failure)g(status.)1110 -2552 y(If)32 b(a)i(comp)s(ound)d(command)i(or)g(shell)g(function)f -(sets)i Ft(-e)e Fu(while)h(executing)1110 2661 y(in)40 -b(a)h(con)m(text)i(where)d Ft(-e)g Fu(is)h(ignored,)j(that)d(setting)h -(will)f(not)g(ha)m(v)m(e)h(an)m(y)1110 2771 y(e\013ect)g(un)m(til)e -(the)h(comp)s(ound)e(command)h(or)g(the)g(command)g(con)m(taining)1110 -2880 y(the)31 b(function)f(call)h(completes.)630 3051 -y Ft(-f)384 b Fu(Disable)31 b(\014lename)g(expansion)f(\(globbing\).) -630 3221 y Ft(-h)384 b Fu(Lo)s(cate)33 b(and)e(remem)m(b)s(er)h -(\(hash\))g(commands)f(as)h(they)g(are)g(lo)s(ok)m(ed)h(up)e(for)1110 -3331 y(execution.)42 b(This)29 b(option)i(is)g(enabled)f(b)m(y)g -(default.)630 3501 y Ft(-k)384 b Fu(All)34 b(argumen)m(ts)g(in)f(the)h -(form)f(of)g(assignmen)m(t)h(statemen)m(ts)i(are)d(placed)h(in)1110 -3611 y(the)k(en)m(vironmen)m(t)g(for)g(a)g(command,)h(not)f(just)f -(those)i(that)f(precede)g(the)1110 3720 y(command)30 -b(name.)630 3891 y Ft(-m)384 b Fu(Job)28 b(con)m(trol)h(is)f(enabled)g +1322 y(part)61 b(of)g(the)g(test)h(in)e(an)h Ft(if)f +Fu(statemen)m(t,)71 b(part)61 b(of)g(an)m(y)g(command)1110 +1431 y(executed)50 b(in)e(a)h Ft(&&)f Fu(or)h Ft(||)f +Fu(list)h(except)g(the)g(command)g(follo)m(wing)h(the)1110 +1541 y(\014nal)37 b Ft(&&)g Fu(or)g Ft(||)p Fu(,)h(an)m(y)g(command)f +(in)g(a)g(pip)s(eline)g(but)g(the)g(last,)j(or)e(if)f(the)1110 +1650 y(command's)c(return)f(status)h(is)g(b)s(eing)g(in)m(v)m(erted)h +(with)e Ft(!)p Fu(.)48 b(If)33 b(a)g(comp)s(ound)1110 +1760 y(command)g(other)g(than)f(a)i(subshell)d(returns)h(a)h(non-zero)h +(status)f(b)s(ecause)1110 1870 y(a)k(command)g(failed)g(while)g +Ft(-e)f Fu(w)m(as)i(b)s(eing)e(ignored,)j(the)e(shell)g(do)s(es)g(not) +1110 1979 y(exit.)42 b(A)30 b(trap)g(on)h Ft(ERR)p Fu(,)e(if)i(set,)g +(is)f(executed)i(b)s(efore)e(the)g(shell)h(exits.)1110 +2107 y(This)f(option)h(applies)f(to)h(the)g(shell)g(en)m(vironmen)m(t)g +(and)f(eac)m(h)h(subshell)f(en-)1110 2217 y(vironmen)m(t)j(separately)i +(\(see)f(Section)g(3.7.3)h([Command)d(Execution)i(En-)1110 +2326 y(vironmen)m(t],)i(page)f(40\),)i(and)d(ma)m(y)h(cause)f +(subshells)g(to)h(exit)g(b)s(efore)f(exe-)1110 2436 y(cuting)d(all)g +(the)g(commands)f(in)g(the)g(subshell.)1110 2564 y(If)41 +b(a)g(comp)s(ound)e(command)i(or)g(shell)g(function)g(executes)h(in)f +(a)g(con)m(text)1110 2673 y(where)31 b Ft(-e)g Fu(is)g(b)s(eing)g +(ignored,)h(none)f(of)h(the)f(commands)g(executed)h(within)1110 +2783 y(the)j(comp)s(ound)f(command)h(or)g(function)f(b)s(o)s(dy)g(will) +h(b)s(e)f(a\013ected)j(b)m(y)e(the)1110 2892 y Ft(-e)25 +b Fu(setting,)j(ev)m(en)e(if)g Ft(-e)f Fu(is)h(set)g(and)f(a)h(command) +g(returns)e(a)i(failure)g(status.)1110 3002 y(If)32 b(a)i(comp)s(ound)d +(command)i(or)g(shell)g(function)f(sets)i Ft(-e)e Fu(while)h(executing) +1110 3112 y(in)40 b(a)h(con)m(text)i(where)d Ft(-e)g +Fu(is)h(ignored,)j(that)d(setting)h(will)f(not)g(ha)m(v)m(e)h(an)m(y) +1110 3221 y(e\013ect)g(un)m(til)e(the)h(comp)s(ound)e(command)h(or)g +(the)g(command)g(con)m(taining)1110 3331 y(the)31 b(function)f(call)h +(completes.)630 3477 y Ft(-f)384 b Fu(Disable)31 b(\014lename)g +(expansion)f(\(globbing\).)630 3623 y Ft(-h)384 b Fu(Lo)s(cate)33 +b(and)e(remem)m(b)s(er)h(\(hash\))g(commands)f(as)h(they)g(are)g(lo)s +(ok)m(ed)h(up)e(for)1110 3733 y(execution.)42 b(This)29 +b(option)i(is)g(enabled)f(b)m(y)g(default.)630 3879 y +Ft(-k)384 b Fu(All)34 b(argumen)m(ts)g(in)f(the)h(form)f(of)g +(assignmen)m(t)h(statemen)m(ts)i(are)d(placed)h(in)1110 +3988 y(the)k(en)m(vironmen)m(t)g(for)g(a)g(command,)h(not)f(just)f +(those)i(that)f(precede)g(the)1110 4098 y(command)30 +b(name.)630 4244 y Ft(-m)384 b Fu(Job)28 b(con)m(trol)h(is)f(enabled)g (\(see)h(Chapter)f(7)g([Job)g(Con)m(trol],)i(page)f(107\).)41 -b(All)1110 4001 y(pro)s(cesses)27 b(run)f(in)i(a)g(separate)g(pro)s +b(All)1110 4354 y(pro)s(cesses)27 b(run)f(in)i(a)g(separate)g(pro)s (cess)f(group.)40 b(When)27 b(a)h(bac)m(kground)f(job)1110 -4110 y(completes,)32 b(the)f(shell)f(prin)m(ts)g(a)h(line)f(con)m -(taining)i(its)f(exit)g(status.)630 4281 y Ft(-n)384 +4463 y(completes,)32 b(the)f(shell)f(prin)m(ts)g(a)h(line)f(con)m +(taining)i(its)f(exit)g(status.)630 4609 y Ft(-n)384 b Fu(Read)38 b(commands)f(but)f(do)i(not)f(execute)i(them.)62 -b(This)37 b(ma)m(y)h(b)s(e)f(used)f(to)1110 4390 y(c)m(hec)m(k)d(a)e +b(This)37 b(ma)m(y)h(b)s(e)f(used)f(to)1110 4719 y(c)m(hec)m(k)d(a)e (script)g(for)g(syn)m(tax)h(errors.)42 b(This)30 b(option)i(is)f -(ignored)g(b)m(y)g(in)m(terac-)1110 4500 y(tiv)m(e)h(shells.)630 -4670 y Ft(-o)e Fj(option-name)1110 4780 y Fu(Set)h(the)f(option)h +(ignored)g(b)m(y)g(in)m(terac-)1110 4829 y(tiv)m(e)h(shells.)630 +4975 y Ft(-o)e Fj(option-name)1110 5084 y Fu(Set)h(the)f(option)h (corresp)s(onding)e(to)i Fr(option-name)5 b Fu(:)1110 -4950 y Ft(allexport)1590 5060 y Fu(Same)30 b(as)h Ft(-a)p -Fu(.)1110 5230 y Ft(braceexpand)1590 5340 y Fu(Same)f(as)h -Ft(-B)p Fu(.)p eop end +5230 y Ft(allexport)1590 5340 y Fu(Same)30 b(as)h Ft(-a)p +Fu(.)p eop end %%Page: 64 70 TeXDict begin 64 69 bop 150 -116 a Fu(Chapter)30 b(4:)41 b(Shell)30 b(Builtin)h(Commands)2069 b(64)1110 299 y -Ft(emacs)240 b Fu(Use)25 b(an)f Ft(emacs)p Fu(-st)m(yle)h(line)f -(editing)h(in)m(terface)h(\(see)g(Chapter)e(8)1590 408 +Ft(braceexpand)1590 408 y Fu(Same)30 b(as)h Ft(-B)p Fu(.)1110 +573 y Ft(emacs)240 b Fu(Use)25 b(an)f Ft(emacs)p Fu(-st)m(yle)h(line)f +(editing)h(in)m(terface)h(\(see)g(Chapter)e(8)1590 682 y([Command)33 b(Line)g(Editing],)h(page)h(111\).)51 b(This)32 -b(also)i(a\013ects)1590 518 y(the)d(editing)g(in)m(terface)h(used)d -(for)h Ft(read)f(-e)p Fu(.)1110 675 y Ft(errexit)144 -b Fu(Same)30 b(as)h Ft(-e)p Fu(.)1110 831 y Ft(errtrace)96 -b Fu(Same)30 b(as)h Ft(-E)p Fu(.)1110 988 y Ft(functrace)1590 -1097 y Fu(Same)f(as)h Ft(-T)p Fu(.)1110 1254 y Ft(hashall)144 -b Fu(Same)30 b(as)h Ft(-h)p Fu(.)1110 1410 y Ft(histexpand)1590 -1520 y Fu(Same)f(as)h Ft(-H)p Fu(.)1110 1677 y Ft(history)144 +b(also)i(a\013ects)1590 792 y(the)d(editing)g(in)m(terface)h(used)d +(for)h Ft(read)f(-e)p Fu(.)1110 956 y Ft(errexit)144 +b Fu(Same)30 b(as)h Ft(-e)p Fu(.)1110 1121 y Ft(errtrace)96 +b Fu(Same)30 b(as)h Ft(-E)p Fu(.)1110 1285 y Ft(functrace)1590 +1395 y Fu(Same)f(as)h Ft(-T)p Fu(.)1110 1559 y Ft(hashall)144 +b Fu(Same)30 b(as)h Ft(-h)p Fu(.)1110 1724 y Ft(histexpand)1590 +1833 y Fu(Same)f(as)h Ft(-H)p Fu(.)1110 1998 y Ft(history)144 b Fu(Enable)39 b(command)g(history)-8 b(,)42 b(as)d(describ)s(ed)f(in)h -(Section)h(9.1)1590 1786 y([Bash)d(History)g(F)-8 b(acilities],)41 -b(page)c(146.)60 b(This)36 b(option)h(is)f(on)1590 1896 +(Section)h(9.1)1590 2107 y([Bash)d(History)g(F)-8 b(acilities],)41 +b(page)c(146.)60 b(This)36 b(option)h(is)f(on)1590 2217 y(b)m(y)30 b(default)h(in)f(in)m(teractiv)m(e)j(shells.)1110 -2052 y Ft(ignoreeof)1590 2162 y Fu(An)d(in)m(teractiv)m(e)j(shell)e -(will)g(not)f(exit)h(up)s(on)e(reading)i(EOF.)1110 2318 +2381 y Ft(ignoreeof)1590 2491 y Fu(An)d(in)m(teractiv)m(e)j(shell)e +(will)g(not)f(exit)h(up)s(on)e(reading)i(EOF.)1110 2655 y Ft(keyword)144 b Fu(Same)30 b(as)h Ft(-k)p Fu(.)1110 -2475 y Ft(monitor)144 b Fu(Same)30 b(as)h Ft(-m)p Fu(.)1110 -2632 y Ft(noclobber)1590 2741 y Fu(Same)f(as)h Ft(-C)p -Fu(.)1110 2898 y Ft(noexec)192 b Fu(Same)30 b(as)h Ft(-n)p -Fu(.)1110 3054 y Ft(noglob)192 b Fu(Same)30 b(as)h Ft(-f)p -Fu(.)1110 3211 y Ft(nolog)240 b Fu(Curren)m(tly)30 b(ignored.)1110 -3367 y Ft(notify)192 b Fu(Same)30 b(as)h Ft(-b)p Fu(.)1110 -3524 y Ft(nounset)144 b Fu(Same)30 b(as)h Ft(-u)p Fu(.)1110 -3680 y Ft(onecmd)192 b Fu(Same)30 b(as)h Ft(-t)p Fu(.)1110 -3837 y Ft(physical)96 b Fu(Same)30 b(as)h Ft(-P)p Fu(.)1110 -3994 y Ft(pipefail)96 b Fu(If)44 b(set,)k(the)d(return)e(v)-5 +2819 y Ft(monitor)144 b Fu(Same)30 b(as)h Ft(-m)p Fu(.)1110 +2984 y Ft(noclobber)1590 3093 y Fu(Same)f(as)h Ft(-C)p +Fu(.)1110 3258 y Ft(noexec)192 b Fu(Same)30 b(as)h Ft(-n)p +Fu(.)1110 3422 y Ft(noglob)192 b Fu(Same)30 b(as)h Ft(-f)p +Fu(.)1110 3587 y Ft(nolog)240 b Fu(Curren)m(tly)30 b(ignored.)1110 +3751 y Ft(notify)192 b Fu(Same)30 b(as)h Ft(-b)p Fu(.)1110 +3915 y Ft(nounset)144 b Fu(Same)30 b(as)h Ft(-u)p Fu(.)1110 +4080 y Ft(onecmd)192 b Fu(Same)30 b(as)h Ft(-t)p Fu(.)1110 +4244 y Ft(physical)96 b Fu(Same)30 b(as)h Ft(-P)p Fu(.)1110 +4408 y Ft(pipefail)96 b Fu(If)44 b(set,)k(the)d(return)e(v)-5 b(alue)45 b(of)f(a)h(pip)s(eline)e(is)i(the)f(v)-5 b(alue)45 -b(of)1590 4103 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h -(exit)g(with)f(a)g(non-zero)1590 4213 y(status,)28 b(or)f(zero)g(if)f +b(of)1590 4518 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h +(exit)g(with)f(a)g(non-zero)1590 4628 y(status,)28 b(or)f(zero)g(if)f (all)i(commands)e(in)g(the)h(pip)s(eline)f(exit)i(suc-)1590 -4322 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h -(default.)1110 4479 y Ft(posix)240 b Fu(Change)30 b(the)g(b)s(eha)m +4737 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h +(default.)1110 4902 y Ft(posix)240 b Fu(Change)30 b(the)g(b)s(eha)m (vior)h(of)f(Bash)g(where)g(the)g(default)h(op)s(era-)1590 -4589 y(tion)25 b(di\013ers)f(from)g(the)h Fm(posix)f -Fu(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 4698 y(dard)h(\(see)j +5011 y(tion)25 b(di\013ers)f(from)g(the)h Fm(posix)f +Fu(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 5121 y(dard)h(\(see)j (Section)f(6.11)h([Bash)f(POSIX)e(Mo)s(de],)j(page)f(101\).)1590 -4808 y(This)37 b(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m(v)m -(e)g(as)g(a)f(strict)h(su-)1590 4917 y(p)s(erset)30 b(of)h(that)f -(standard.)1110 5074 y Ft(privileged)1590 5183 y Fu(Same)g(as)h -Ft(-p)p Fu(.)1110 5340 y Ft(verbose)144 b Fu(Same)30 -b(as)h Ft(-v)p Fu(.)p eop end +5230 y(This)37 b(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m(v)m +(e)g(as)g(a)f(strict)h(su-)1590 5340 y(p)s(erset)30 b(of)h(that)f +(standard.)p eop end %%Page: 65 71 TeXDict begin 65 70 bop 150 -116 a Fu(Chapter)30 b(4:)41 b(Shell)30 b(Builtin)h(Commands)2069 b(65)1110 299 y -Ft(vi)384 b Fu(Use)36 b(a)g Ft(vi)p Fu(-st)m(yle)g(line)g(editing)g(in) -m(terface.)58 b(This)35 b(also)h(a\013ects)1590 408 y(the)31 -b(editing)g(in)m(terface)h(used)d(for)h Ft(read)f(-e)p -Fu(.)1110 555 y Ft(xtrace)192 b Fu(Same)30 b(as)h Ft(-x)p -Fu(.)630 701 y Ft(-p)384 b Fu(T)-8 b(urn)33 b(on)h(privileged)h(mo)s -(de.)51 b(In)34 b(this)g(mo)s(de,)h(the)f Ft($BASH_ENV)e -Fu(and)h Ft($ENV)1110 810 y Fu(\014les)23 b(are)h(not)f(pro)s(cessed,)h -(shell)g(functions)e(are)i(not)f(inherited)g(from)f(the)i(en-)1110 -920 y(vironmen)m(t,)h(and)e(the)g Ft(SHELLOPTS)p Fu(,)f -Ft(BASHOPTS)p Fu(,)h Ft(CDPATH)e Fu(and)i Ft(GLOBIGNORE)1110 -1029 y Fu(v)-5 b(ariables,)23 b(if)e(they)g(app)s(ear)f(in)g(the)h(en)m -(vironmen)m(t,)i(are)e(ignored.)38 b(If)20 b(the)h(shell)1110 -1139 y(is)37 b(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d -(\(group\))g(id)g(not)g(equal)h(to)g(the)f(real)1110 -1249 y(user)h(\(group\))h(id,)i(and)d(the)h Ft(-p)f Fu(option)i(is)e -(not)i(supplied,)f(these)h(actions)1110 1358 y(are)32 -b(tak)m(en)i(and)d(the)h(e\013ectiv)m(e)j(user)c(id)h(is)g(set)h(to)f -(the)h(real)f(user)g(id.)45 b(If)32 b(the)1110 1468 y -Ft(-p)i Fu(option)h(is)g(supplied)f(at)h(startup,)h(the)f(e\013ectiv)m -(e)i(user)d(id)g(is)h(not)g(reset.)1110 1577 y(T)-8 b(urning)35 -b(this)i(option)g(o\013)g(causes)g(the)g(e\013ectiv)m(e)i(user)d(and)g -(group)g(ids)g(to)1110 1687 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f -(and)g(group)g(ids.)630 1833 y Ft(-t)384 b Fu(Exit)31 -b(after)g(reading)f(and)g(executing)h(one)g(command.)630 -1979 y Ft(-u)384 b Fu(T)-8 b(reat)25 b(unset)e(v)-5 b(ariables)25 -b(and)e(parameters)h(other)h(than)e(the)h(sp)s(ecial)h(param-)1110 -2089 y(eters)35 b(`)p Ft(@)p Fu(')f(or)g(`)p Ft(*)p Fu(')h(as)f(an)g -(error)g(when)f(p)s(erforming)g(parameter)i(expansion.)1110 -2198 y(An)28 b(error)h(message)g(will)g(b)s(e)f(written)h(to)h(the)e -(standard)g(error,)h(and)f(a)h(non-)1110 2308 y(in)m(teractiv)m(e)k -(shell)e(will)g(exit.)630 2454 y Ft(-v)384 b Fu(Prin)m(t)30 -b(shell)h(input)e(lines)i(as)g(they)f(are)h(read.)630 -2600 y Ft(-x)384 b Fu(Prin)m(t)21 b(a)h(trace)h(of)f(simple)f -(commands,)i Ft(for)e Fu(commands,)i Ft(case)d Fu(commands,)1110 -2710 y Ft(select)29 b Fu(commands,)j(and)e(arithmetic)j -Ft(for)d Fu(commands)h(and)f(their)i(argu-)1110 2819 -y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f(are) -h(expanded)f(and)f(b)s(efore)1110 2929 y(they)i(are)g(executed.)49 +Ft(privileged)1590 408 y Fu(Same)30 b(as)h Ft(-p)p Fu(.)1110 +569 y Ft(verbose)144 b Fu(Same)30 b(as)h Ft(-v)p Fu(.)1110 +729 y Ft(vi)384 b Fu(Use)36 b(a)g Ft(vi)p Fu(-st)m(yle)g(line)g +(editing)g(in)m(terface.)58 b(This)35 b(also)h(a\013ects)1590 +838 y(the)31 b(editing)g(in)m(terface)h(used)d(for)h +Ft(read)f(-e)p Fu(.)1110 999 y Ft(xtrace)192 b Fu(Same)30 +b(as)h Ft(-x)p Fu(.)630 1159 y Ft(-p)384 b Fu(T)-8 b(urn)33 +b(on)h(privileged)h(mo)s(de.)51 b(In)34 b(this)g(mo)s(de,)h(the)f +Ft($BASH_ENV)e Fu(and)h Ft($ENV)1110 1268 y Fu(\014les)23 +b(are)h(not)f(pro)s(cessed,)h(shell)g(functions)e(are)i(not)f +(inherited)g(from)f(the)i(en-)1110 1378 y(vironmen)m(t,)h(and)e(the)g +Ft(SHELLOPTS)p Fu(,)f Ft(BASHOPTS)p Fu(,)h Ft(CDPATH)e +Fu(and)i Ft(GLOBIGNORE)1110 1487 y Fu(v)-5 b(ariables,)23 +b(if)e(they)g(app)s(ear)f(in)g(the)h(en)m(vironmen)m(t,)i(are)e +(ignored.)38 b(If)20 b(the)h(shell)1110 1597 y(is)37 +b(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d(\(group\))g(id)g(not)g +(equal)h(to)g(the)f(real)1110 1707 y(user)h(\(group\))h(id,)i(and)d +(the)h Ft(-p)f Fu(option)i(is)e(not)i(supplied,)f(these)h(actions)1110 +1816 y(are)32 b(tak)m(en)i(and)d(the)h(e\013ectiv)m(e)j(user)c(id)h(is) +g(set)h(to)f(the)h(real)f(user)g(id.)45 b(If)32 b(the)1110 +1926 y Ft(-p)i Fu(option)h(is)g(supplied)f(at)h(startup,)h(the)f +(e\013ectiv)m(e)i(user)d(id)g(is)h(not)g(reset.)1110 +2035 y(T)-8 b(urning)35 b(this)i(option)g(o\013)g(causes)g(the)g +(e\013ectiv)m(e)i(user)d(and)g(group)g(ids)g(to)1110 +2145 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f(and)g(group)g(ids.)630 +2305 y Ft(-t)384 b Fu(Exit)31 b(after)g(reading)f(and)g(executing)h +(one)g(command.)630 2465 y Ft(-u)384 b Fu(T)-8 b(reat)25 +b(unset)e(v)-5 b(ariables)25 b(and)e(parameters)h(other)h(than)e(the)h +(sp)s(ecial)h(param-)1110 2575 y(eters)35 b(`)p Ft(@)p +Fu(')f(or)g(`)p Ft(*)p Fu(')h(as)f(an)g(error)g(when)f(p)s(erforming)g +(parameter)i(expansion.)1110 2685 y(An)28 b(error)h(message)g(will)g(b) +s(e)f(written)h(to)h(the)e(standard)g(error,)h(and)f(a)h(non-)1110 +2794 y(in)m(teractiv)m(e)k(shell)e(will)g(exit.)630 2954 +y Ft(-v)384 b Fu(Prin)m(t)30 b(shell)h(input)e(lines)i(as)g(they)f(are) +h(read.)630 3114 y Ft(-x)384 b Fu(Prin)m(t)21 b(a)h(trace)h(of)f +(simple)f(commands,)i Ft(for)e Fu(commands,)i Ft(case)d +Fu(commands,)1110 3224 y Ft(select)29 b Fu(commands,)j(and)e +(arithmetic)j Ft(for)d Fu(commands)h(and)f(their)i(argu-)1110 +3334 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f +(are)h(expanded)f(and)f(b)s(efore)1110 3443 y(they)i(are)g(executed.)49 b(The)32 b(v)-5 b(alue)33 b(of)g(the)g Ft(PS4)f Fu(v)-5 -b(ariable)34 b(is)f(expanded)f(and)1110 3039 y(the)24 +b(ariable)34 b(is)f(expanded)f(and)1110 3553 y(the)24 b(resultan)m(t)h(v)-5 b(alue)24 b(is)g(prin)m(ted)g(b)s(efore)f(the)h -(command)g(and)f(its)i(expanded)1110 3148 y(argumen)m(ts.)630 -3294 y Ft(-B)384 b Fu(The)41 b(shell)g(will)g(p)s(erform)f(brace)h -(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 3404 +(command)g(and)f(its)i(expanded)1110 3662 y(argumen)m(ts.)630 +3823 y Ft(-B)384 b Fu(The)41 b(shell)g(will)g(p)s(erform)f(brace)h +(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 3932 y(Expansion],)30 b(page)h(23\).)42 b(This)30 b(option)h(is)f(on)g(b)m -(y)h(default.)630 3550 y Ft(-C)384 b Fu(Prev)m(en)m(t)25 +(y)h(default.)630 4092 y Ft(-C)384 b Fu(Prev)m(en)m(t)25 b(output)e(redirection)h(using)f(`)p Ft(>)p Fu(',)i(`)p Ft(>&)p Fu(',)g(and)e(`)p Ft(<>)p Fu(')g(from)h(o)m(v)m(erwriting)1110 -3660 y(existing)31 b(\014les.)630 3806 y Ft(-E)384 b +4202 y(existing)31 b(\014les.)630 4362 y Ft(-E)384 b Fu(If)39 b(set,)j(an)m(y)e(trap)f(on)g Ft(ERR)g Fu(is)g(inherited)g(b)m -(y)g(shell)h(functions,)h(command)1110 3915 y(substitutions,)35 +(y)g(shell)h(functions,)h(command)1110 4472 y(substitutions,)35 b(and)e(commands)g(executed)i(in)f(a)g(subshell)f(en)m(vironmen)m(t.) -1110 4025 y(The)d Ft(ERR)f Fu(trap)i(is)f(normally)h(not)f(inherited)g -(in)g(suc)m(h)g(cases.)630 4171 y Ft(-H)384 b Fu(Enable)38 +1110 4581 y(The)d Ft(ERR)f Fu(trap)i(is)f(normally)h(not)f(inherited)g +(in)g(suc)m(h)g(cases.)630 4741 y Ft(-H)384 b Fu(Enable)38 b(`)p Ft(!)p Fu(')h(st)m(yle)h(history)e(substitution)g(\(see)h -(Section)h(9.3)f([History)g(In-)1110 4281 y(teraction],)g(page)d +(Section)h(9.3)f([History)g(In-)1110 4851 y(teraction],)g(page)d (148\).)57 b(This)34 b(option)i(is)f(on)g(b)m(y)h(default)f(for)g(in)m -(teractiv)m(e)1110 4390 y(shells.)630 4536 y Ft(-P)384 +(teractiv)m(e)1110 4961 y(shells.)630 5121 y Ft(-P)384 b Fu(If)39 b(set,)j(do)d(not)g(resolv)m(e)i(sym)m(b)s(olic)e(links)g -(when)f(p)s(erforming)g(commands)1110 4646 y(suc)m(h)29 +(when)f(p)s(erforming)g(commands)1110 5230 y(suc)m(h)29 b(as)h Ft(cd)f Fu(whic)m(h)g(c)m(hange)h(the)g(curren)m(t)f(directory) --8 b(.)42 b(The)28 b(ph)m(ysical)j(direc-)1110 4756 y(tory)j(is)g(used) +-8 b(.)42 b(The)28 b(ph)m(ysical)j(direc-)1110 5340 y(tory)j(is)g(used) f(instead.)52 b(By)34 b(default,)h(Bash)f(follo)m(ws)h(the)f(logical)i -(c)m(hain)f(of)1110 4865 y(directories)j(when)d(p)s(erforming)h -(commands)g(whic)m(h)g(c)m(hange)i(the)f(curren)m(t)1110 -4975 y(directory)-8 b(.)1110 5103 y(F)g(or)42 b(example,)i(if)d -Ft(/usr/sys)e Fu(is)i(a)g(sym)m(b)s(olic)g(link)g(to)h -Ft(/usr/local/sys)1110 5212 y Fu(then:)1350 5340 y Ft($)47 -b(cd)h(/usr/sys;)d(echo)i($PWD)p eop end +(c)m(hain)f(of)p eop end %%Page: 66 72 TeXDict begin 66 71 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(66)1350 299 y -Ft(/usr/sys)1350 408 y($)47 b(cd)h(..;)f(pwd)1350 518 -y(/usr)1110 652 y Fu(If)30 b Ft(set)f(-P)h Fu(is)h(on,)f(then:)1350 -786 y Ft($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 895 -y(/usr/local/sys)1350 1005 y($)g(cd)h(..;)f(pwd)1350 -1114 y(/usr/local)630 1272 y(-T)384 b Fu(If)34 b(set,)j(an)m(y)e(trap)g -(on)g Ft(DEBUG)e Fu(and)i Ft(RETURN)e Fu(are)i(inherited)g(b)m(y)f -(shell)i(func-)1110 1382 y(tions,)k(command)d(substitutions,)h(and)f -(commands)g(executed)h(in)f(a)h(sub-)1110 1491 y(shell)33 -b(en)m(vironmen)m(t.)49 b(The)32 b Ft(DEBUG)g Fu(and)g -Ft(RETURN)f Fu(traps)h(are)i(normally)f(not)1110 1601 -y(inherited)d(in)g(suc)m(h)g(cases.)630 1759 y Ft(--)384 -b Fu(If)44 b(no)g(argumen)m(ts)g(follo)m(w)i(this)e(option,)k(then)c -(the)h(p)s(ositional)g(parame-)1110 1869 y(ters)31 b(are)g(unset.)40 -b(Otherwise,)31 b(the)f(p)s(ositional)i(parameters)f(are)f(set)h(to)h -(the)1110 1978 y Fr(argumen)m(ts)p Fu(,)f(ev)m(en)g(if)f(some)h(of)g -(them)f(b)s(egin)g(with)g(a)h(`)p Ft(-)p Fu('.)630 2136 -y Ft(-)432 b Fu(Signal)45 b(the)g(end)f(of)h(options,)k(cause)c(all)h -(remaining)e Fr(argumen)m(ts)49 b Fu(to)d(b)s(e)1110 -2246 y(assigned)33 b(to)h(the)g(p)s(ositional)g(parameters.)49 -b(The)33 b Ft(-x)g Fu(and)f Ft(-v)h Fu(options)h(are)1110 -2355 y(turned)k(o\013.)68 b(If)38 b(there)i(are)f(no)g(argumen)m(ts,)j -(the)e(p)s(ositional)g(parameters)1110 2465 y(remain)30 -b(unc)m(hanged.)630 2623 y(Using)d(`)p Ft(+)p Fu(')h(rather)f(than)g(`) +b(Shell)30 b(Builtin)h(Commands)2069 b(66)1110 299 y(directories)38 +b(when)d(p)s(erforming)h(commands)g(whic)m(h)g(c)m(hange)i(the)f +(curren)m(t)1110 408 y(directory)-8 b(.)1110 542 y(F)g(or)42 +b(example,)i(if)d Ft(/usr/sys)e Fu(is)i(a)g(sym)m(b)s(olic)g(link)g(to) +h Ft(/usr/local/sys)1110 651 y Fu(then:)1350 784 y Ft($)47 +b(cd)h(/usr/sys;)d(echo)i($PWD)1350 894 y(/usr/sys)1350 +1003 y($)g(cd)h(..;)f(pwd)1350 1113 y(/usr)1110 1246 +y Fu(If)30 b Ft(set)f(-P)h Fu(is)h(on,)f(then:)1350 1379 +y Ft($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 1489 y(/usr/local/sys) +1350 1599 y($)g(cd)h(..;)f(pwd)1350 1708 y(/usr/local)630 +1865 y(-T)384 b Fu(If)34 b(set,)j(an)m(y)e(trap)g(on)g +Ft(DEBUG)e Fu(and)i Ft(RETURN)e Fu(are)i(inherited)g(b)m(y)f(shell)i +(func-)1110 1974 y(tions,)k(command)d(substitutions,)h(and)f(commands)g +(executed)h(in)f(a)h(sub-)1110 2084 y(shell)33 b(en)m(vironmen)m(t.)49 +b(The)32 b Ft(DEBUG)g Fu(and)g Ft(RETURN)f Fu(traps)h(are)i(normally)f +(not)1110 2194 y(inherited)d(in)g(suc)m(h)g(cases.)630 +2350 y Ft(--)384 b Fu(If)44 b(no)g(argumen)m(ts)g(follo)m(w)i(this)e +(option,)k(then)c(the)h(p)s(ositional)g(parame-)1110 +2460 y(ters)31 b(are)g(unset.)40 b(Otherwise,)31 b(the)f(p)s(ositional) +i(parameters)f(are)f(set)h(to)h(the)1110 2569 y Fr(argumen)m(ts)p +Fu(,)f(ev)m(en)g(if)f(some)h(of)g(them)f(b)s(egin)g(with)g(a)h(`)p +Ft(-)p Fu('.)630 2726 y Ft(-)432 b Fu(Signal)45 b(the)g(end)f(of)h +(options,)k(cause)c(all)h(remaining)e Fr(argumen)m(ts)49 +b Fu(to)d(b)s(e)1110 2836 y(assigned)33 b(to)h(the)g(p)s(ositional)g +(parameters.)49 b(The)33 b Ft(-x)g Fu(and)f Ft(-v)h Fu(options)h(are) +1110 2945 y(turned)k(o\013.)68 b(If)38 b(there)i(are)f(no)g(argumen)m +(ts,)j(the)e(p)s(ositional)g(parameters)1110 3055 y(remain)30 +b(unc)m(hanged.)630 3211 y(Using)d(`)p Ft(+)p Fu(')h(rather)f(than)g(`) p Ft(-)p Fu(')g(causes)h(these)f(options)h(to)g(b)s(e)e(turned)g -(o\013.)40 b(The)27 b(options)h(can)630 2732 y(also)36 +(o\013.)40 b(The)27 b(options)h(can)630 3321 y(also)36 b(b)s(e)f(used)f(up)s(on)g(in)m(v)m(o)s(cation)j(of)e(the)g(shell.)56 b(The)34 b(curren)m(t)h(set)h(of)f(options)h(ma)m(y)g(b)s(e)630 -2842 y(found)29 b(in)h Ft($-)p Fu(.)630 2976 y(The)43 +3431 y(found)29 b(in)h Ft($-)p Fu(.)630 3564 y(The)43 b(remaining)h(N)f Fr(argumen)m(ts)48 b Fu(are)c(p)s(ositional)g -(parameters)g(and)f(are)h(assigned,)j(in)630 3085 y(order,)30 +(parameters)g(and)f(are)h(assigned,)j(in)630 3673 y(order,)30 b(to)h Ft($1)p Fu(,)f Ft($2)p Fu(,)36 b(.)22 b(.)g(.)42 b Ft($N)p Fu(.)e(The)30 b(sp)s(ecial)h(parameter)g Ft(#)f -Fu(is)g(set)h(to)g(N.)630 3219 y(The)f(return)f(status)i(is)f(alw)m(a)m +Fu(is)g(set)h(to)g(N.)630 3806 y(The)f(return)f(status)i(is)f(alw)m(a)m (ys)i(zero)f(unless)f(an)g(in)m(v)-5 b(alid)31 b(option)g(is)f -(supplied.)150 3417 y Fk(4.3.2)63 b(The)41 b(Shopt)h(Builtin)150 -3564 y Fu(This)30 b(builtin)g(allo)m(ws)h(y)m(ou)g(to)g(c)m(hange)h +(supplied.)150 4003 y Fk(4.3.2)63 b(The)41 b(Shopt)h(Builtin)150 +4150 y Fu(This)30 b(builtin)g(allo)m(ws)h(y)m(ou)g(to)g(c)m(hange)h (additional)f(shell)f(optional)i(b)s(eha)m(vior.)150 -3722 y Ft(shopt)870 3856 y(shopt)46 b([-pqsu])g([-o])h([)p -Fj(optname)e Ft(...])630 3989 y Fu(T)-8 b(oggle)37 b(the)e(v)-5 +4307 y Ft(shopt)870 4440 y(shopt)46 b([-pqsu])g([-o])h([)p +Fj(optname)e Ft(...])630 4573 y Fu(T)-8 b(oggle)37 b(the)e(v)-5 b(alues)35 b(of)g(settings)h(con)m(trolling)g(optional)g(shell)f(b)s -(eha)m(vior.)55 b(The)34 b(settings)630 4099 y(can)24 +(eha)m(vior.)55 b(The)34 b(settings)630 4682 y(can)24 b(b)s(e)g(either)h(those)f(listed)h(b)s(elo)m(w,)h(or,)f(if)g(the)f Ft(-o)f Fu(option)i(is)f(used,)h(those)g(a)m(v)-5 b(ailable)26 -b(with)630 4209 y(the)k Ft(-o)f Fu(option)i(to)f(the)g +b(with)630 4792 y(the)k Ft(-o)f Fu(option)i(to)f(the)g Ft(set)f Fu(builtin)h(command)f(\(see)i(Section)g(4.3.1)g([The)f(Set)g -(Builtin],)630 4318 y(page)i(62\).)45 b(With)32 b(no)f(options,)h(or)g +(Builtin],)630 4902 y(page)i(62\).)45 b(With)32 b(no)f(options,)h(or)g (with)f(the)g Ft(-p)g Fu(option,)h(a)g(list)g(of)f(all)i(settable)g -(options)630 4428 y(is)g(displa)m(y)m(ed,)i(with)e(an)g(indication)h +(options)630 5011 y(is)g(displa)m(y)m(ed,)i(with)e(an)g(indication)h (of)g(whether)e(or)h(not)h(eac)m(h)g(is)g(set;)h(if)e -Fr(optnames)38 b Fu(are)630 4537 y(supplied,)25 b(the)g(output)g(is)g +Fr(optnames)38 b Fu(are)630 5121 y(supplied,)25 b(the)g(output)g(is)g (restricted)g(to)h(those)g(options.)39 b(The)24 b Ft(-p)h -Fu(option)g(causes)g(output)630 4647 y(to)30 b(b)s(e)f(displa)m(y)m(ed) +Fu(option)g(causes)g(output)630 5230 y(to)30 b(b)s(e)f(displa)m(y)m(ed) g(in)g(a)h(form)f(that)g(ma)m(y)h(b)s(e)f(reused)f(as)i(input.)39 -b(Other)29 b(options)g(ha)m(v)m(e)i(the)630 4757 y(follo)m(wing)h -(meanings:)630 4914 y Ft(-s)384 b Fu(Enable)30 b(\(set\))i(eac)m(h)f -Fr(optname)p Fu(.)630 5072 y Ft(-u)384 b Fu(Disable)31 -b(\(unset\))g(eac)m(h)h Fr(optname)p Fu(.)630 5230 y -Ft(-q)384 b Fu(Suppresses)28 b(normal)h(output;)h(the)g(return)e -(status)i(indicates)h(whether)e(the)1110 5340 y Fr(optname)37 -b Fu(is)31 b(set)h(or)f(unset.)43 b(If)31 b(m)m(ultiple)h -Fr(optname)37 b Fu(argumen)m(ts)31 b(are)h(giv)m(en)p -eop end +b(Other)29 b(options)g(ha)m(v)m(e)i(the)630 5340 y(follo)m(wing)h +(meanings:)p eop end %%Page: 67 73 TeXDict begin 67 72 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(67)1110 299 y(with)29 -b Ft(-q)p Fu(,)g(the)g(return)f(status)h(is)g(zero)h(if)f(all)h -Fr(optnames)j Fu(are)d(enabled;)f(non-)1110 408 y(zero)i(otherwise.)630 -570 y Ft(-o)384 b Fu(Restricts)22 b(the)f(v)-5 b(alues)22 -b(of)f Fr(optname)27 b Fu(to)22 b(b)s(e)e(those)i(de\014ned)e(for)h -(the)g Ft(-o)f Fu(option)1110 680 y(to)31 b(the)g Ft(set)e +b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Ft(-s)384 +b Fu(Enable)30 b(\(set\))i(eac)m(h)f Fr(optname)p Fu(.)630 +456 y Ft(-u)384 b Fu(Disable)31 b(\(unset\))g(eac)m(h)h +Fr(optname)p Fu(.)630 613 y Ft(-q)384 b Fu(Suppresses)28 +b(normal)h(output;)h(the)g(return)e(status)i(indicates)h(whether)e(the) +1110 723 y Fr(optname)37 b Fu(is)31 b(set)h(or)f(unset.)43 +b(If)31 b(m)m(ultiple)h Fr(optname)37 b Fu(argumen)m(ts)31 +b(are)h(giv)m(en)1110 833 y(with)d Ft(-q)p Fu(,)g(the)g(return)f +(status)h(is)g(zero)h(if)f(all)h Fr(optnames)j Fu(are)d(enabled;)f +(non-)1110 942 y(zero)i(otherwise.)630 1099 y Ft(-o)384 +b Fu(Restricts)22 b(the)f(v)-5 b(alues)22 b(of)f Fr(optname)27 +b Fu(to)22 b(b)s(e)e(those)i(de\014ned)e(for)h(the)g +Ft(-o)f Fu(option)1110 1209 y(to)31 b(the)g Ft(set)e Fu(builtin)h(\(see)h(Section)h(4.3.1)g([The)e(Set)g(Builtin],)i(page)f -(62\).)630 842 y(If)e(either)i Ft(-s)e Fu(or)h Ft(-u)f +(62\).)630 1366 y(If)e(either)i Ft(-s)e Fu(or)h Ft(-u)f Fu(is)h(used)f(with)g(no)h Fr(optname)35 b Fu(argumen)m(ts,)c -Ft(shopt)d Fu(sho)m(ws)h(only)h(those)630 951 y(options)h(whic)m(h)f +Ft(shopt)d Fu(sho)m(ws)h(only)h(those)630 1476 y(options)h(whic)m(h)f (are)h(set)f(or)h(unset,)f(resp)s(ectiv)m(ely)-8 b(.)630 -1087 y(Unless)30 b(otherwise)h(noted,)g(the)g Ft(shopt)d +1609 y(Unless)30 b(otherwise)h(noted,)g(the)g Ft(shopt)d Fu(options)j(are)g(disabled)f(\(o\013)7 b(\))32 b(b)m(y)e(default.)630 -1223 y(The)d(return)f(status)i(when)f(listing)h(options)g(is)f(zero)i +1743 y(The)d(return)f(status)i(when)f(listing)h(options)g(is)f(zero)i (if)e(all)i Fr(optnames)i Fu(are)d(enabled,)g(non-)630 -1332 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f(unsetting)g -(options,)i(the)e(return)f(status)h(is)g(zero)630 1442 +1852 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f(unsetting)g +(options,)i(the)e(return)f(status)h(is)g(zero)630 1962 y(unless)30 b(an)g Fr(optname)36 b Fu(is)30 b(not)h(a)g(v)-5 -b(alid)30 b(shell)h(option.)630 1577 y(The)f(list)h(of)f -Ft(shopt)f Fu(options)i(is:)630 1739 y Ft(assoc_expand_once)1110 -1849 y Fu(If)h(set,)i(the)e(shell)h(suppresses)e(m)m(ultiple)i(ev)-5 +b(alid)30 b(shell)h(option.)630 2095 y(The)f(list)h(of)f +Ft(shopt)f Fu(options)i(is:)630 2252 y Ft(assoc_expand_once)1110 +2362 y Fu(If)h(set,)i(the)e(shell)h(suppresses)e(m)m(ultiple)i(ev)-5 b(aluation)34 b(of)e(asso)s(ciativ)m(e)j(arra)m(y)1110 -1958 y(subscripts)24 b(during)h(arithmetic)h(expression)g(ev)-5 -b(aluation,)28 b(while)e(executing)1110 2068 y(builtins)c(that)i(can)f +2472 y(subscripts)24 b(during)h(arithmetic)h(expression)g(ev)-5 +b(aluation,)28 b(while)e(executing)1110 2581 y(builtins)c(that)i(can)f (p)s(erform)f(v)-5 b(ariable)24 b(assignmen)m(ts,)h(and)e(while)g -(executing)1110 2178 y(builtins)30 b(that)h(p)s(erform)e(arra)m(y)i -(dereferencing.)630 2339 y Ft(autocd)192 b Fu(If)27 b(set,)h(a)g +(executing)1110 2691 y(builtins)30 b(that)h(p)s(erform)e(arra)m(y)i +(dereferencing.)630 2848 y Ft(autocd)192 b Fu(If)27 b(set,)h(a)g (command)f(name)g(that)h(is)f(the)g(name)g(of)h(a)f(directory)h(is)f -(executed)1110 2449 y(as)j(if)f(it)h(w)m(ere)f(the)h(argumen)m(t)g(to)g +(executed)1110 2958 y(as)j(if)f(it)h(w)m(ere)f(the)h(argumen)m(t)g(to)g (the)f Ft(cd)g Fu(command.)40 b(This)29 b(option)g(is)h(only)1110 -2559 y(used)g(b)m(y)g(in)m(teractiv)m(e)j(shells.)630 -2720 y Ft(cdable_vars)1110 2830 y Fu(If)h(this)h(is)g(set,)i(an)e +3067 y(used)g(b)m(y)g(in)m(teractiv)m(e)j(shells.)630 +3224 y Ft(cdable_vars)1110 3334 y Fu(If)h(this)h(is)g(set,)i(an)e (argumen)m(t)g(to)h(the)f Ft(cd)f Fu(builtin)h(command)f(that)i(is)f -(not)1110 2939 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h +(not)1110 3444 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h (name)f(of)h(a)g(v)-5 b(ariable)31 b(whose)g(v)-5 b(alue)31 -b(is)1110 3049 y(the)g(directory)f(to)i(c)m(hange)f(to.)630 -3211 y Ft(cdspell)144 b Fu(If)27 b(set,)h(minor)f(errors)f(in)h(the)g +b(is)1110 3553 y(the)g(directory)f(to)i(c)m(hange)f(to.)630 +3710 y Ft(cdspell)144 b Fu(If)27 b(set,)h(minor)f(errors)f(in)h(the)g (sp)s(elling)h(of)f(a)g(directory)h(comp)s(onen)m(t)f(in)g(a)h -Ft(cd)1110 3320 y Fu(command)i(will)h(b)s(e)f(corrected.)43 +Ft(cd)1110 3820 y Fu(command)i(will)h(b)s(e)f(corrected.)43 b(The)30 b(errors)g(c)m(hec)m(k)m(ed)j(for)d(are)h(transp)s(osed)1110 -3430 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47 +3930 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47 b(and)40 b(a)i(c)m(haracter)h(to)s(o)g(man)m(y)-8 b(.)74 -b(If)42 b(a)1110 3540 y(correction)25 b(is)e(found,)g(the)h(corrected)g -(path)f(is)g(prin)m(ted,)h(and)f(the)g(command)1110 3649 +b(If)42 b(a)1110 4039 y(correction)25 b(is)e(found,)g(the)h(corrected)g +(path)f(is)g(prin)m(ted,)h(and)f(the)g(command)1110 4149 y(pro)s(ceeds.)40 b(This)30 b(option)h(is)f(only)h(used)e(b)m(y)h(in)m -(teractiv)m(e)k(shells.)630 3811 y Ft(checkhash)1110 -3921 y Fu(If)29 b(this)h(is)g(set,)g(Bash)g(c)m(hec)m(ks)h(that)g(a)f -(command)f(found)g(in)g(the)h(hash)f(table)1110 4030 +(teractiv)m(e)k(shells.)630 4306 y Ft(checkhash)1110 +4416 y Fu(If)29 b(this)h(is)g(set,)g(Bash)g(c)m(hec)m(ks)h(that)g(a)f +(command)f(found)g(in)g(the)h(hash)f(table)1110 4525 y(exists)k(b)s(efore)f(trying)h(to)h(execute)g(it.)48 -b(If)32 b(a)h(hashed)e(command)i(no)f(longer)1110 4140 +b(If)32 b(a)h(hashed)e(command)i(no)f(longer)1110 4635 y(exists,)f(a)g(normal)f(path)g(searc)m(h)h(is)g(p)s(erformed.)630 -4301 y Ft(checkjobs)1110 4411 y Fu(If)d(set,)i(Bash)e(lists)h(the)g +4792 y Ft(checkjobs)1110 4902 y Fu(If)d(set,)i(Bash)e(lists)h(the)g (status)g(of)f(an)m(y)h(stopp)s(ed)f(and)g(running)e(jobs)i(b)s(efore) -1110 4521 y(exiting)42 b(an)f(in)m(teractiv)m(e)j(shell.)72 +1110 5011 y(exiting)42 b(an)f(in)m(teractiv)m(e)j(shell.)72 b(If)41 b(an)m(y)g(jobs)f(are)i(running,)g(this)f(causes)1110 -4630 y(the)30 b(exit)g(to)g(b)s(e)f(deferred)g(un)m(til)h(a)f(second)h -(exit)g(is)g(attempted)h(without)e(an)1110 4740 y(in)m(terv)m(ening)d +5121 y(the)30 b(exit)g(to)g(b)s(e)f(deferred)g(un)m(til)h(a)f(second)h +(exit)g(is)g(attempted)h(without)e(an)1110 5230 y(in)m(terv)m(ening)d (command)f(\(see)h(Chapter)e(7)h([Job)g(Con)m(trol],)i(page)f(107\).)40 -b(The)1110 4849 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h -(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 5011 y Ft(checkwinsize)1110 -5121 y Fu(If)23 b(set,)j(Bash)e(c)m(hec)m(ks)h(the)f(windo)m(w)f(size)h -(after)h(eac)m(h)f(external)h(\(non-builtin\))1110 5230 -y(command)55 b(and,)60 b(if)55 b(necessary)-8 b(,)62 -b(up)s(dates)54 b(the)h(v)-5 b(alues)55 b(of)g Ft(LINES)f -Fu(and)1110 5340 y Ft(COLUMNS)p Fu(.)39 b(This)29 b(option)i(is)g -(enabled)f(b)m(y)g(default.)p eop end +b(The)1110 5340 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h +(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)p eop end %%Page: 68 74 TeXDict begin 68 73 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(68)630 299 y Ft(cmdhist)144 +b(Shell)30 b(Builtin)h(Commands)2069 b(68)630 299 y Ft(checkwinsize) +1110 408 y Fu(If)23 b(set,)j(Bash)e(c)m(hec)m(ks)h(the)f(windo)m(w)f +(size)h(after)h(eac)m(h)f(external)h(\(non-builtin\))1110 +518 y(command)55 b(and,)60 b(if)55 b(necessary)-8 b(,)62 +b(up)s(dates)54 b(the)h(v)-5 b(alues)55 b(of)g Ft(LINES)f +Fu(and)1110 628 y Ft(COLUMNS)p Fu(.)39 b(This)29 b(option)i(is)g +(enabled)f(b)m(y)g(default.)630 800 y Ft(cmdhist)144 b Fu(If)33 b(set,)j(Bash)e(attempts)h(to)g(sa)m(v)m(e)g(all)g(lines)f -(of)g(a)h(m)m(ultiple-line)g(command)1110 408 y(in)c(the)g(same)g +(of)g(a)h(m)m(ultiple-line)g(command)1110 909 y(in)c(the)g(same)g (history)g(en)m(try)-8 b(.)42 b(This)30 b(allo)m(ws)i(easy)g -(re-editing)g(of)f(m)m(ulti-line)1110 518 y(commands.)79 +(re-editing)g(of)f(m)m(ulti-line)1110 1019 y(commands.)79 b(This)43 b(option)g(is)h(enabled)f(b)m(y)g(default,)k(but)c(only)g -(has)g(an)1110 628 y(e\013ect)30 b(if)e(command)g(history)g(is)h +(has)g(an)1110 1129 y(e\013ect)30 b(if)e(command)g(history)g(is)h (enabled)f(\(see)h(Section)g(9.1)h([Bash)e(History)1110 -737 y(F)-8 b(acilities],)34 b(page)d(146\).)630 909 y -Ft(compat31)630 1019 y(compat32)630 1129 y(compat40)630 -1238 y(compat41)630 1348 y(compat42)630 1457 y(compat43)630 -1567 y(compat44)96 b Fu(These)39 b(con)m(trol)i(asp)s(ects)f(of)f(the)h +1238 y(F)-8 b(acilities],)34 b(page)d(146\).)630 1410 +y Ft(compat31)630 1520 y(compat32)630 1630 y(compat40)630 +1739 y(compat41)630 1849 y(compat42)630 1958 y(compat43)630 +2068 y(compat44)96 b Fu(These)39 b(con)m(trol)i(asp)s(ects)f(of)f(the)h (shell's)g(compatibilit)m(y)h(mo)s(de)e(\(see)h(Sec-)1110 -1677 y(tion)31 b(6.12)h([Shell)e(Compatibilit)m(y)i(Mo)s(de],)f(page)g -(104\).)630 1849 y Ft(complete_fullquote)1110 1958 y +2178 y(tion)31 b(6.12)h([Shell)e(Compatibilit)m(y)i(Mo)s(de],)f(page)g +(104\).)630 2350 y Ft(complete_fullquote)1110 2459 y Fu(If)g(set,)g(Bash)h(quotes)f(all)h(shell)f(metac)m(haracters)i(in)e -(\014lenames)g(and)g(direc-)1110 2068 y(tory)g(names)f(when)g(p)s +(\014lenames)g(and)g(direc-)1110 2569 y(tory)g(names)f(when)g(p)s (erforming)f(completion.)43 b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m -(es)1110 2178 y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g -(sign)g(from)f(the)h(set)g(of)f(c)m(haracters)1110 2287 +(es)1110 2679 y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g +(sign)g(from)f(the)h(set)g(of)f(c)m(haracters)1110 2788 y(that)f(will)g(b)s(e)f(quoted)g(in)g(completed)i(\014lenames)e(when)f -(these)i(metac)m(har-)1110 2397 y(acters)29 b(app)s(ear)e(in)g(shell)h +(these)i(metac)m(har-)1110 2898 y(acters)29 b(app)s(ear)e(in)g(shell)h (v)-5 b(ariable)28 b(references)g(in)f(w)m(ords)g(to)i(b)s(e)e -(completed.)1110 2506 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v) +(completed.)1110 3007 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v) -5 b(ariable)33 b(names)g(that)f(expand)g(to)h(di-)1110 -2616 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,) -g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 2725 +3117 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,) +g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 3226 y(\014lenames)j(will)h(not)f(b)s(e)g(quoted,)h(either.)41 b(This)28 b(is)i(activ)m(e)h(only)e(when)g(bash)1110 -2835 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f -(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 2945 +3336 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f +(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 3446 y(is)41 b(set)g(b)m(y)g(default,)j(whic)m(h)c(is)h(the)g(default)g -(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3054 y(through)30 -b(4.2.)630 3226 y Ft(direxpand)1110 3336 y Fu(If)k(set,)i(Bash)f +(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3555 y(through)30 +b(4.2.)630 3727 y Ft(direxpand)1110 3837 y Fu(If)k(set,)i(Bash)f (replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g -(ex-)1110 3446 y(pansion)k(when)g(p)s(erforming)f(\014lename)i -(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 3555 +(ex-)1110 3947 y(pansion)k(when)g(p)s(erforming)f(\014lename)i +(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 4056 y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38 -b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 3665 +b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 4166 y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630 -3837 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s +4338 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s (elling)g(correction)g(on)g(directory)g(names)f(during)1110 -3947 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g -(initially)h(supplied)e(do)s(es)h(not)1110 4056 y(exist.)630 -4228 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g +4448 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g +(initially)h(supplied)e(do)s(es)h(not)1110 4557 y(exist.)630 +4729 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g (\014lenames)g(b)s(eginning)f(with)h(a)g(`.')58 b(in)36 -b(the)g(results)1110 4338 y(of)f(\014lename)f(expansion.)53 +b(the)g(results)1110 4839 y(of)f(\014lename)f(expansion.)53 b(The)33 b(\014lenames)i(`)p Ft(.)p Fu(')f(and)g(`)p -Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 4448 +Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 4949 y(matc)m(hed)31 b(explicitly)-8 b(,)33 b(ev)m(en)e(if)f -Ft(dotglob)f Fu(is)h(set.)630 4620 y Ft(execfail)96 b +Ft(dotglob)f Fu(is)h(set.)630 5121 y Ft(execfail)96 b Fu(If)24 b(this)h(is)f(set,)j(a)e(non-in)m(teractiv)m(e)i(shell)e(will) -f(not)h(exit)h(if)e(it)h(cannot)h(execute)1110 4729 y(the)i(\014le)g +f(not)h(exit)h(if)e(it)h(cannot)h(execute)1110 5230 y(the)i(\014le)g (sp)s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to)h(the)f -Ft(exec)f Fu(builtin)h(command.)39 b(An)1110 4839 y(in)m(teractiv)m(e) -33 b(shell)e(do)s(es)f(not)g(exit)i(if)e Ft(exec)f Fu(fails.)630 -5011 y Ft(expand_aliases)1110 5121 y Fu(If)j(set,)h(aliases)g(are)g -(expanded)e(as)h(describ)s(ed)f(b)s(elo)m(w)h(under)f(Aliases,)i(Sec-) -1110 5230 y(tion)38 b(6.6)h([Aliases],)j(page)d(94.)64 -b(This)37 b(option)h(is)g(enabled)g(b)m(y)g(default)g(for)1110 -5340 y(in)m(teractiv)m(e)33 b(shells.)p eop end +Ft(exec)f Fu(builtin)h(command.)39 b(An)1110 5340 y(in)m(teractiv)m(e) +33 b(shell)e(do)s(es)f(not)g(exit)i(if)e Ft(exec)f Fu(fails.)p +eop end %%Page: 69 75 TeXDict begin 69 74 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(69)630 299 y Ft(extdebug)96 +b(Shell)30 b(Builtin)h(Commands)2069 b(69)630 299 y Ft(expand_aliases) +1110 408 y Fu(If)32 b(set,)h(aliases)g(are)g(expanded)e(as)h(describ)s +(ed)f(b)s(elo)m(w)h(under)f(Aliases,)i(Sec-)1110 518 +y(tion)38 b(6.6)h([Aliases],)j(page)d(94.)64 b(This)37 +b(option)h(is)g(enabled)g(b)m(y)g(default)g(for)1110 +628 y(in)m(teractiv)m(e)33 b(shells.)630 786 y Ft(extdebug)96 b Fu(If)35 b(set)i(at)f(shell)g(in)m(v)m(o)s(cation,)k(or)c(in)f(a)h (shell)h(startup)e(\014le,)i(arrange)g(to)f(ex-)1110 -408 y(ecute)h(the)f(debugger)g(pro\014le)g(b)s(efore)g(the)g(shell)h -(starts,)h(iden)m(tical)g(to)f(the)1110 518 y Ft(--debugger)32 +896 y(ecute)h(the)f(debugger)g(pro\014le)g(b)s(efore)g(the)g(shell)h +(starts,)h(iden)m(tical)g(to)f(the)1110 1005 y Ft(--debugger)32 b Fu(option.)56 b(If)35 b(set)h(after)g(in)m(v)m(o)s(cation,)j(b)s(eha) -m(vior)c(in)m(tended)g(for)1110 628 y(use)30 b(b)m(y)g(debuggers)g(is)h -(enabled:)1159 756 y(1.)61 b(The)37 b Ft(-F)g Fu(option)h(to)g(the)g +m(vior)c(in)m(tended)g(for)1110 1115 y(use)30 b(b)m(y)g(debuggers)g(is) +h(enabled:)1159 1249 y(1.)61 b(The)37 b Ft(-F)g Fu(option)h(to)g(the)g Ft(declare)d Fu(builtin)i(\(see)i(Section)f(4.2)h([Bash)1290 -865 y(Builtins],)29 b(page)g(51\))g(displa)m(ys)f(the)g(source)h -(\014le)f(name)g(and)f(line)h(n)m(um-)1290 975 y(b)s(er)h(corresp)s +1358 y(Builtins],)29 b(page)g(51\))g(displa)m(ys)f(the)g(source)h +(\014le)f(name)g(and)f(line)h(n)m(um-)1290 1468 y(b)s(er)h(corresp)s (onding)g(to)i(eac)m(h)g(function)f(name)g(supplied)f(as)i(an)f(argu-) -1290 1084 y(men)m(t.)1159 1212 y(2.)61 b(If)20 b(the)h(command)g(run)e +1290 1577 y(men)m(t.)1159 1711 y(2.)61 b(If)20 b(the)h(command)g(run)e (b)m(y)i(the)f Ft(DEBUG)g Fu(trap)g(returns)g(a)h(non-zero)g(v)-5 -b(alue,)1290 1322 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g -(not)i(executed.)1159 1450 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m +b(alue,)1290 1821 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g +(not)i(executed.)1159 1955 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m (y)i(the)f Ft(DEBUG)f Fu(trap)h(returns)f(a)i(v)-5 b(alue)38 -b(of)f(2,)1290 1559 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h -(subroutine)e(\(a)i(shell)g(function)f(or)1290 1669 y(a)h(shell)g +b(of)f(2,)1290 2064 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h +(subroutine)e(\(a)i(shell)g(function)f(or)1290 2174 y(a)h(shell)g (script)f(executed)h(b)m(y)g(the)f Ft(.)h Fu(or)f Ft(source)f -Fu(builtins\),)i(the)g(shell)1290 1778 y(sim)m(ulates)d(a)g(call)h(to)f -Ft(return)p Fu(.)1159 1906 y(4.)61 b Ft(BASH_ARGC)34 +Fu(builtins\),)i(the)g(shell)1290 2284 y(sim)m(ulates)d(a)g(call)h(to)f +Ft(return)p Fu(.)1159 2418 y(4.)61 b Ft(BASH_ARGC)34 b Fu(and)i Ft(BASH_ARGV)e Fu(are)j(up)s(dated)e(as)h(describ)s(ed)g(in) -g(their)1290 2016 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g -(V)-8 b(ariables],)32 b(page)f(73\).)1159 2144 y(5.)61 +g(their)1290 2527 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g +(V)-8 b(ariables],)32 b(page)f(73\).)1159 2661 y(5.)61 b(F)-8 b(unction)57 b(tracing)g(is)g(enabled:)93 b(command)56 -b(substitution,)63 b(shell)1290 2253 y(functions,)32 +b(substitution,)63 b(shell)1290 2771 y(functions,)32 b(and)e(subshells)h(in)m(v)m(ok)m(ed)i(with)e Ft(\()f -Fj(command)e Ft(\))j Fu(inherit)h(the)1290 2363 y Ft(DEBUG)d -Fu(and)h Ft(RETURN)e Fu(traps.)1159 2491 y(6.)61 b(Error)41 +Fj(command)e Ft(\))j Fu(inherit)h(the)1290 2880 y Ft(DEBUG)d +Fu(and)h Ft(RETURN)e Fu(traps.)1159 3014 y(6.)61 b(Error)41 b(tracing)i(is)f(enabled:)63 b(command)42 b(substitution,)i(shell)f -(func-)1290 2600 y(tions,)32 b(and)e(subshells)g(in)m(v)m(ok)m(ed)i +(func-)1290 3124 y(tions,)32 b(and)e(subshells)g(in)m(v)m(ok)m(ed)i (with)e Ft(\()g Fj(command)f Ft(\))h Fu(inherit)h(the)g -Ft(ERR)1290 2710 y Fu(trap.)630 2856 y Ft(extglob)144 +Ft(ERR)1290 3233 y Fu(trap.)630 3392 y Ft(extglob)144 b Fu(If)26 b(set,)i(the)f(extended)f(pattern)h(matc)m(hing)g(features)g -(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 2966 y(Section)j(3.5.8.1)i +(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 3501 y(Section)j(3.5.8.1)i ([P)m(attern)f(Matc)m(hing],)g(page)f(33\))h(are)f(enabled.)630 -3112 y Ft(extquote)96 b Fu(If)51 b(set,)58 b Ft($')p +3660 y Ft(extquote)96 b Fu(If)51 b(set,)58 b Ft($')p Fj(string)p Ft(')49 b Fu(and)i Ft($")p Fj(string)p Ft(")e -Fu(quoting)k(is)e(p)s(erformed)f(within)1110 3221 y Ft(${)p +Fu(quoting)k(is)e(p)s(erformed)f(within)1110 3769 y Ft(${)p Fj(parameter)p Ft(})31 b Fu(expansions)k(enclosed)g(in)g(double)f -(quotes.)55 b(This)33 b(option)1110 3331 y(is)d(enabled)h(b)m(y)f -(default.)630 3477 y Ft(failglob)96 b Fu(If)36 b(set,)j(patterns)d +(quotes.)55 b(This)33 b(option)1110 3879 y(is)d(enabled)h(b)m(y)f +(default.)630 4037 y Ft(failglob)96 b Fu(If)36 b(set,)j(patterns)d (whic)m(h)g(fail)h(to)h(matc)m(h)f(\014lenames)f(during)g(\014lename)g -(ex-)1110 3587 y(pansion)30 b(result)g(in)g(an)g(expansion)h(error.)630 -3733 y Ft(force_fignore)1110 3842 y Fu(If)43 b(set,)k(the)d(su\016xes)f +(ex-)1110 4147 y(pansion)30 b(result)g(in)g(an)g(expansion)h(error.)630 +4305 y Ft(force_fignore)1110 4415 y Fu(If)43 b(set,)k(the)d(su\016xes)f (sp)s(eci\014ed)f(b)m(y)i(the)f Ft(FIGNORE)f Fu(shell)h(v)-5 -b(ariable)44 b(cause)1110 3952 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h +b(ariable)44 b(cause)1110 4524 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h (when)f(p)s(erforming)f(w)m(ord)h(completion)i(ev)m(en)f(if)g(the)1110 -4061 y(ignored)37 b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g -(completions.)62 b(See)37 b(Section)h(5.2)1110 4171 y([Bash)24 +4634 y(ignored)37 b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g +(completions.)62 b(See)37 b(Section)h(5.2)1110 4743 y([Bash)24 b(V)-8 b(ariables],)27 b(page)e(73,)h(for)d(a)h(description)g(of)g -Ft(FIGNORE)p Fu(.)37 b(This)22 b(option)1110 4281 y(is)30 -b(enabled)h(b)m(y)f(default.)630 4427 y Ft(globasciiranges)1110 -4536 y Fu(If)j(set,)h(range)f(expressions)g(used)f(in)h(pattern)g(matc) -m(hing)h(brac)m(k)m(et)h(expres-)1110 4646 y(sions)28 +Ft(FIGNORE)p Fu(.)37 b(This)22 b(option)1110 4853 y(is)30 +b(enabled)h(b)m(y)f(default.)630 5011 y Ft(globasciiranges)1110 +5121 y Fu(If)j(set,)h(range)f(expressions)g(used)f(in)h(pattern)g(matc) +m(hing)h(brac)m(k)m(et)h(expres-)1110 5230 y(sions)28 b(\(see)h(Section)h(3.5.8.1)g([P)m(attern)g(Matc)m(hing],)h(page)e -(33\))g(b)s(eha)m(v)m(e)g(as)g(if)1110 4756 y(in)i(the)g(traditional)i +(33\))g(b)s(eha)m(v)m(e)g(as)g(if)1110 5340 y(in)i(the)g(traditional)i (C)d(lo)s(cale)j(when)d(p)s(erforming)g(comparisons.)44 -b(That)31 b(is,)1110 4865 y(the)d(curren)m(t)g(lo)s(cale's)i(collating) -h(sequence)d(is)h(not)f(tak)m(en)h(in)m(to)g(accoun)m(t,)i(so)1110 -4975 y(`)p Ft(b)p Fu(')j(will)g(not)g(collate)i(b)s(et)m(w)m(een)e(`)p -Ft(A)p Fu(')g(and)f(`)p Ft(B)p Fu(',)h(and)f(upp)s(er-case)g(and)g(lo)m -(w)m(er-)1110 5084 y(case)e(ASCI)s(I)e(c)m(haracters)j(will)f(collate)i -(together.)630 5230 y Ft(globstar)96 b Fu(If)38 b(set,)j(the)e(pattern) -f(`)p Ft(**)p Fu(')h(used)e(in)i(a)f(\014lename)h(expansion)f(con)m -(text)j(will)1110 5340 y(matc)m(h)36 b(all)g(\014les)f(and)f(zero)i(or) -f(more)g(directories)h(and)e(sub)s(directories.)54 b(If)p -eop end +b(That)31 b(is,)p eop end %%Page: 70 76 TeXDict begin 70 75 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(70)1110 299 y(the)30 -b(pattern)g(is)g(follo)m(w)m(ed)i(b)m(y)d(a)i(`)p Ft(/)p -Fu(',)f(only)g(directories)h(and)f(sub)s(directories)1110 -408 y(matc)m(h.)630 558 y Ft(gnu_errfmt)1110 667 y Fu(If)35 -b(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)h(the)g -(standard)f Fm(gnu)g Fu(error)1110 777 y(message)c(format.)630 -927 y Ft(histappend)1110 1036 y Fu(If)c(set,)j(the)e(history)g(list)g +b(Shell)30 b(Builtin)h(Commands)2069 b(70)1110 299 y(the)28 +b(curren)m(t)g(lo)s(cale's)i(collating)h(sequence)d(is)h(not)f(tak)m +(en)h(in)m(to)g(accoun)m(t,)i(so)1110 408 y(`)p Ft(b)p +Fu(')j(will)g(not)g(collate)i(b)s(et)m(w)m(een)e(`)p +Ft(A)p Fu(')g(and)f(`)p Ft(B)p Fu(',)h(and)f(upp)s(er-case)g(and)g(lo)m +(w)m(er-)1110 518 y(case)e(ASCI)s(I)e(c)m(haracters)j(will)f(collate)i +(together.)630 693 y Ft(globstar)96 b Fu(If)38 b(set,)j(the)e(pattern)f +(`)p Ft(**)p Fu(')h(used)e(in)i(a)f(\014lename)h(expansion)f(con)m +(text)j(will)1110 803 y(matc)m(h)36 b(all)g(\014les)f(and)f(zero)i(or)f +(more)g(directories)h(and)e(sub)s(directories.)54 b(If)1110 +913 y(the)30 b(pattern)g(is)g(follo)m(w)m(ed)i(b)m(y)d(a)i(`)p +Ft(/)p Fu(',)f(only)g(directories)h(and)f(sub)s(directories)1110 +1022 y(matc)m(h.)630 1198 y Ft(gnu_errfmt)1110 1307 y +Fu(If)35 b(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)h(the)g +(standard)f Fm(gnu)g Fu(error)1110 1417 y(message)c(format.)630 +1592 y Ft(histappend)1110 1702 y Fu(If)c(set,)j(the)e(history)g(list)g (is)g(app)s(ended)e(to)j(the)f(\014le)g(named)f(b)m(y)h(the)g(v)-5 -b(alue)29 b(of)1110 1146 y(the)d Ft(HISTFILE)d Fu(v)-5 +b(alue)29 b(of)1110 1811 y(the)d Ft(HISTFILE)d Fu(v)-5 b(ariable)26 b(when)e(the)h(shell)h(exits,)h(rather)e(than)h(o)m(v)m -(erwriting)1110 1255 y(the)31 b(\014le.)630 1405 y Ft(histreedit)1110 -1514 y Fu(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g +(erwriting)1110 1921 y(the)31 b(\014le.)630 2096 y Ft(histreedit)1110 +2206 y Fu(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g (user)g(is)g(giv)m(en)h(the)g(opp)s(ortunit)m(y)1110 -1624 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630 -1773 y Ft(histverify)1110 1883 y Fu(If)35 b(set,)i(and)e(Readline)h(is) +2315 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630 +2491 y Ft(histverify)1110 2600 y Fu(If)35 b(set,)i(and)e(Readline)h(is) f(b)s(eing)g(used,)h(the)f(results)g(of)g(history)h(substitu-)1110 -1993 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g -(parser.)59 b(Instead,)38 b(the)1110 2102 y(resulting)i(line)f(is)h +2710 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g +(parser.)59 b(Instead,)38 b(the)1110 2819 y(resulting)i(line)f(is)h (loaded)g(in)m(to)g(the)g(Readline)g(editing)g(bu\013er,)h(allo)m(wing) -1110 2212 y(further)29 b(mo)s(di\014cation.)630 2361 -y Ft(hostcomplete)1110 2471 y Fu(If)38 b(set,)j(and)c(Readline)i(is)f +1110 2929 y(further)29 b(mo)s(di\014cation.)630 3104 +y Ft(hostcomplete)1110 3214 y Fu(If)38 b(set,)j(and)c(Readline)i(is)f (b)s(eing)g(used,)h(Bash)g(will)f(attempt)h(to)g(p)s(erform)1110 -2580 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f -(`)p Ft(@)p Fu(')g(is)g(b)s(eing)f(com-)1110 2690 y(pleted)g(\(see)h +3324 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f +(`)p Ft(@)p Fu(')g(is)g(b)s(eing)f(com-)1110 3433 y(pleted)g(\(see)h (Section)f(8.4.6)i([Commands)d(F)-8 b(or)36 b(Completion],)g(page)g -(132\).)1110 2800 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.) -630 2949 y Ft(huponexit)1110 3059 y Fu(If)i(set,)i(Bash)f(will)h(send)d +(133\).)1110 3543 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.) +630 3718 y Ft(huponexit)1110 3828 y Fu(If)i(set,)i(Bash)f(will)h(send)d Ft(SIGHUP)h Fu(to)h(all)h(jobs)e(when)g(an)g(in)m(teractiv)m(e)k(login) -1110 3168 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g -(page)f(42\).)630 3318 y Ft(inherit_errexit)1110 3427 +1110 3937 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g +(page)f(42\).)630 4113 y Ft(inherit_errexit)1110 4222 y Fu(If)e(set,)h(command)g(substitution)f(inherits)g(the)g(v)-5 -b(alue)30 b(of)g(the)f Ft(errexit)f Fu(op-)1110 3537 +b(alue)30 b(of)g(the)f Ft(errexit)f Fu(op-)1110 4332 y(tion,)33 b(instead)g(of)f(unsetting)g(it)h(in)f(the)g(subshell)f(en)m -(vironmen)m(t.)46 b(This)32 b(op-)1110 3646 y(tion)f(is)f(enabled)h -(when)e Fm(posix)h Fu(mo)s(de)g(is)g(enabled.)630 3796 -y Ft(interactive_comments)1110 3905 y Fu(Allo)m(w)d(a)g(w)m(ord)e(b)s +(vironmen)m(t.)46 b(This)32 b(op-)1110 4441 y(tion)f(is)f(enabled)h +(when)e Fm(posix)h Fu(mo)s(de)g(is)g(enabled.)630 4617 +y Ft(interactive_comments)1110 4726 y Fu(Allo)m(w)d(a)g(w)m(ord)e(b)s (eginning)g(with)h(`)p Ft(#)p Fu(')g(to)h(cause)f(that)h(w)m(ord)f(and) -f(all)i(remain-)1110 4015 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g +f(all)i(remain-)1110 4836 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g (to)g(b)s(e)f(ignored)g(in)g(an)g(in)m(teractiv)m(e)j(shell.)1110 -4125 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 -4274 y Ft(lastpipe)96 b Fu(If)24 b(set,)i(and)e(job)g(con)m(trol)i(is)f +4945 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 +5121 y Ft(lastpipe)96 b Fu(If)24 b(set,)i(and)e(job)g(con)m(trol)i(is)f (not)f(activ)m(e,)k(the)d(shell)f(runs)f(the)i(last)g(command)1110 -4384 y(of)37 b(a)h(pip)s(eline)e(not)h(executed)h(in)f(the)g(bac)m -(kground)g(in)g(the)g(curren)m(t)g(shell)1110 4493 y(en)m(vironmen)m -(t.)630 4643 y Ft(lithist)144 b Fu(If)22 b(enabled,)i(and)d(the)h -Ft(cmdhist)e Fu(option)j(is)f(enabled,)i(m)m(ulti-line)f(commands)1110 -4752 y(are)28 b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s -(edded)g(newlines)h(rather)g(than)f(using)1110 4862 y(semicolon)32 -b(separators)f(where)e(p)s(ossible.)630 5011 y Ft(localvar_inherit)1110 -5121 y Fu(If)j(set,)h(lo)s(cal)g(v)-5 b(ariables)33 b(inherit)f(the)g -(v)-5 b(alue)32 b(and)g(attributes)h(of)f(a)g(v)-5 b(ariable)1110 -5230 y(of)36 b(the)g(same)g(name)g(that)h(exists)f(at)h(a)f(previous)g -(scop)s(e)g(b)s(efore)f(an)m(y)h(new)1110 5340 y(v)-5 -b(alue)31 b(is)f(assigned.)41 b(The)30 b Fr(nameref)48 -b Fu(attribute)31 b(is)f(not)h(inherited.)p eop end +5230 y(of)37 b(a)h(pip)s(eline)e(not)h(executed)h(in)f(the)g(bac)m +(kground)g(in)g(the)g(curren)m(t)g(shell)1110 5340 y(en)m(vironmen)m +(t.)p eop end %%Page: 71 77 TeXDict begin 71 76 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft(localvar_unset) -1110 408 y Fu(If)33 b(set,)i(calling)g Ft(unset)d Fu(on)i(lo)s(cal)g(v) --5 b(ariables)35 b(in)e(previous)g(function)g(scop)s(es)1110 -518 y(marks)26 b(them)g(so)g(subsequen)m(t)g(lo)s(okups)f(\014nd)g -(them)h(unset)f(un)m(til)i(that)g(func-)1110 628 y(tion)40 -b(returns.)68 b(This)39 b(is)g(iden)m(tical)j(to)e(the)g(b)s(eha)m -(vior)g(of)g(unsetting)g(lo)s(cal)1110 737 y(v)-5 b(ariables)31 -b(at)g(the)g(curren)m(t)f(function)g(scop)s(e.)630 891 -y Ft(login_shell)1110 1000 y Fu(The)35 b(shell)h(sets)g(this)f(option)h -(if)g(it)g(is)f(started)h(as)g(a)g(login)g(shell)g(\(see)g(Sec-)1110 -1110 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(86\).)41 -b(The)28 b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m(hanged.)630 -1263 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h(\014le)g(that)g -(Bash)f(is)h(c)m(hec)m(king)h(for)f(mail)g(has)f(b)s(een)g(accessed) -1110 1373 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m -(ed,)k(the)c(message)h Ft("The)k(mail)h(in)f Fj(mail-)1110 -1482 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y)m(ed.)630 -1636 y Ft(no_empty_cmd_completion)1110 1745 y Fu(If)g(set,)g(and)g -(Readline)g(is)h(b)s(eing)e(used,)h(Bash)g(will)g(not)g(attempt)i(to)e -(searc)m(h)1110 1855 y(the)25 b Ft(PATH)f Fu(for)h(p)s(ossible)f -(completions)j(when)d(completion)i(is)f(attempted)h(on)1110 -1965 y(an)k(empt)m(y)h(line.)630 2118 y Ft(nocaseglob)1110 -2228 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h -(case-insensitiv)m(e)j(fashion)c(when)1110 2337 y(p)s(erforming)29 -b(\014lename)i(expansion.)630 2491 y Ft(nocasematch)1110 -2600 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h -(case-insensitiv)m(e)i(fashion)d(when)1110 2710 y(p)s(erforming)31 -b(matc)m(hing)i(while)f(executing)i Ft(case)d Fu(or)h -Ft([[)g Fu(conditional)h(com-)1110 2819 y(mands,)d(when)g(p)s -(erforming)g(pattern)h(substitution)g(w)m(ord)g(expansions,)g(or)1110 -2929 y(when)g(\014ltering)i(p)s(ossible)f(completions)h(as)g(part)f(of) -h(programmable)f(com-)1110 3039 y(pletion.)630 3192 y -Ft(nullglob)96 b Fu(If)23 b(set,)j(Bash)e(allo)m(ws)g(\014lename)g -(patterns)g(whic)m(h)f(matc)m(h)h(no)g(\014les)f(to)i(expand)1110 -3302 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.) -630 3455 y Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g -(completion)g(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110 -3565 y(grammable)45 b(Completion],)k(page)c(137\))h(are)f(enabled.)82 -b(This)44 b(option)h(is)1110 3674 y(enabled)30 b(b)m(y)h(default.)630 -3828 y Ft(progcomp_alias)1110 3937 y Fu(If)23 b(set,)j(and)d +b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft(lithist)144 +b Fu(If)22 b(enabled,)i(and)d(the)h Ft(cmdhist)e Fu(option)j(is)f +(enabled,)i(m)m(ulti-line)f(commands)1110 408 y(are)28 +b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s(edded)g(newlines)h +(rather)g(than)f(using)1110 518 y(semicolon)32 b(separators)f(where)e +(p)s(ossible.)630 682 y Ft(localvar_inherit)1110 792 +y Fu(If)j(set,)h(lo)s(cal)g(v)-5 b(ariables)33 b(inherit)f(the)g(v)-5 +b(alue)32 b(and)g(attributes)h(of)f(a)g(v)-5 b(ariable)1110 +902 y(of)36 b(the)g(same)g(name)g(that)h(exists)f(at)h(a)f(previous)g +(scop)s(e)g(b)s(efore)f(an)m(y)h(new)1110 1011 y(v)-5 +b(alue)31 b(is)f(assigned.)41 b(The)30 b Fr(nameref)48 +b Fu(attribute)31 b(is)f(not)h(inherited.)630 1176 y +Ft(localvar_unset)1110 1285 y Fu(If)i(set,)i(calling)g +Ft(unset)d Fu(on)i(lo)s(cal)g(v)-5 b(ariables)35 b(in)e(previous)g +(function)g(scop)s(es)1110 1395 y(marks)26 b(them)g(so)g(subsequen)m(t) +g(lo)s(okups)f(\014nd)g(them)h(unset)f(un)m(til)i(that)g(func-)1110 +1504 y(tion)40 b(returns.)68 b(This)39 b(is)g(iden)m(tical)j(to)e(the)g +(b)s(eha)m(vior)g(of)g(unsetting)g(lo)s(cal)1110 1614 +y(v)-5 b(ariables)31 b(at)g(the)g(curren)m(t)f(function)g(scop)s(e.)630 +1778 y Ft(login_shell)1110 1888 y Fu(The)35 b(shell)h(sets)g(this)f +(option)h(if)g(it)g(is)f(started)h(as)g(a)g(login)g(shell)g(\(see)g +(Sec-)1110 1998 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g +(86\).)41 b(The)28 b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m +(hanged.)630 2162 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h +(\014le)g(that)g(Bash)f(is)h(c)m(hec)m(king)h(for)f(mail)g(has)f(b)s +(een)g(accessed)1110 2271 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as) +f(c)m(hec)m(k)m(ed,)k(the)c(message)h Ft("The)k(mail)h(in)f +Fj(mail-)1110 2381 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y) +m(ed.)630 2545 y Ft(no_empty_cmd_completion)1110 2655 +y Fu(If)g(set,)g(and)g(Readline)g(is)h(b)s(eing)e(used,)h(Bash)g(will)g +(not)g(attempt)i(to)e(searc)m(h)1110 2765 y(the)25 b +Ft(PATH)f Fu(for)h(p)s(ossible)f(completions)j(when)d(completion)i(is)f +(attempted)h(on)1110 2874 y(an)k(empt)m(y)h(line.)630 +3039 y Ft(nocaseglob)1110 3148 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g +(\014lenames)g(in)f(a)h(case-insensitiv)m(e)j(fashion)c(when)1110 +3258 y(p)s(erforming)29 b(\014lename)i(expansion.)630 +3422 y Ft(nocasematch)1110 3532 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g +(patterns)g(in)f(a)h(case-insensitiv)m(e)i(fashion)d(when)1110 +3641 y(p)s(erforming)31 b(matc)m(hing)i(while)f(executing)i +Ft(case)d Fu(or)h Ft([[)g Fu(conditional)h(com-)1110 +3751 y(mands,)d(when)g(p)s(erforming)g(pattern)h(substitution)g(w)m +(ord)g(expansions,)g(or)1110 3861 y(when)g(\014ltering)i(p)s(ossible)f +(completions)h(as)g(part)f(of)h(programmable)f(com-)1110 +3970 y(pletion.)630 4134 y Ft(nullglob)96 b Fu(If)23 +b(set,)j(Bash)e(allo)m(ws)g(\014lename)g(patterns)g(whic)m(h)f(matc)m +(h)h(no)g(\014les)f(to)i(expand)1110 4244 y(to)31 b(a)g(n)m(ull)f +(string,)h(rather)f(than)g(themselv)m(es.)630 4408 y +Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g(completion)g +(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110 4518 +y(grammable)45 b(Completion],)k(page)c(137\))h(are)f(enabled.)82 +b(This)44 b(option)h(is)1110 4628 y(enabled)30 b(b)m(y)h(default.)630 +4792 y Ft(progcomp_alias)1110 4902 y Fu(If)23 b(set,)j(and)d (programmable)h(completion)h(is)f(enabled,)h(Bash)f(treats)h(a)f(com-) -1110 4047 y(mand)34 b(name)h(that)g(do)s(esn't)f(ha)m(v)m(e)i(an)m(y)g -(completions)f(as)g(a)g(p)s(ossible)g(alias)1110 4156 +1110 5011 y(mand)34 b(name)h(that)g(do)s(esn't)f(ha)m(v)m(e)i(an)m(y)g +(completions)f(as)g(a)g(p)s(ossible)g(alias)1110 5121 y(and)40 b(attempts)i(alias)h(expansion.)72 b(If)41 b(it)g(has)g(an)g -(alias,)k(Bash)c(attempts)1110 4266 y(programmable)28 +(alias,)k(Bash)c(attempts)1110 5230 y(programmable)28 b(completion)h(using)e(the)h(command)f(w)m(ord)h(resulting)f(from)1110 -4376 y(the)k(expanded)e(alias.)630 4529 y Ft(promptvars)1110 -4639 y Fu(If)50 b(set,)56 b(prompt)49 b(strings)h(undergo)g(parameter)h -(expansion,)k(command)1110 4748 y(substitution,)35 b(arithmetic)g -(expansion,)g(and)e(quote)i(remo)m(v)-5 b(al)35 b(after)f(b)s(eing)1110 -4858 y(expanded)53 b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section) -f(6.9)h([Con)m(trolling)g(the)1110 4967 y(Prompt],)30 -b(page)h(98\).)42 b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.) -630 5121 y Ft(restricted_shell)1110 5230 y Fu(The)40 -b(shell)h(sets)g(this)g(option)g(if)g(it)h(is)e(started)i(in)e -(restricted)i(mo)s(de)e(\(see)1110 5340 y(Section)32 -b(6.10)h([The)d(Restricted)j(Shell],)e(page)h(100\).)45 -b(The)30 b(v)-5 b(alue)32 b(ma)m(y)g(not)p eop end +5340 y(the)k(expanded)e(alias.)p eop end %%Page: 72 78 TeXDict begin 72 77 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(72)1110 299 y(b)s(e)32 -b(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f(the)h(startup)g -(\014les)f(are)i(executed,)1110 408 y(allo)m(wing)k(the)e(startup)f -(\014les)h(to)g(disco)m(v)m(er)h(whether)f(or)f(not)i(a)f(shell)g(is)g -(re-)1110 518 y(stricted.)630 677 y Ft(shift_verbose)1110 -787 y Fu(If)g(this)g(is)g(set,)j(the)d Ft(shift)f Fu(builtin)h(prin)m -(ts)f(an)h(error)g(message)i(when)d(the)1110 897 y(shift)30 -b(coun)m(t)h(exceeds)g(the)g(n)m(um)m(b)s(er)e(of)h(p)s(ositional)i -(parameters.)630 1056 y Ft(sourcepath)1110 1166 y Fu(If)22 -b(set,)j(the)e Ft(source)e Fu(builtin)h(uses)g(the)h(v)-5 -b(alue)23 b(of)g Ft(PATH)e Fu(to)j(\014nd)d(the)h(directory)1110 -1275 y(con)m(taining)29 b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m -(t.)40 b(This)27 b(option)h(is)f(enabled)1110 1385 y(b)m(y)j(default.) -630 1544 y Ft(xpg_echo)96 b Fu(If)31 b(set,)h(the)g Ft(echo)e +b(Shell)30 b(Builtin)h(Commands)2069 b(72)630 299 y Ft(promptvars)1110 +408 y Fu(If)50 b(set,)56 b(prompt)49 b(strings)h(undergo)g(parameter)h +(expansion,)k(command)1110 518 y(substitution,)35 b(arithmetic)g +(expansion,)g(and)e(quote)i(remo)m(v)-5 b(al)35 b(after)f(b)s(eing)1110 +628 y(expanded)53 b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section)f +(6.9)h([Con)m(trolling)g(the)1110 737 y(Prompt],)30 b(page)h(98\).)42 +b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.)630 +897 y Ft(restricted_shell)1110 1006 y Fu(The)40 b(shell)h(sets)g(this)g +(option)g(if)g(it)h(is)e(started)i(in)e(restricted)i(mo)s(de)e(\(see) +1110 1116 y(Section)32 b(6.10)h([The)d(Restricted)j(Shell],)e(page)h +(100\).)45 b(The)30 b(v)-5 b(alue)32 b(ma)m(y)g(not)1110 +1225 y(b)s(e)g(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f +(the)h(startup)g(\014les)f(are)i(executed,)1110 1335 +y(allo)m(wing)k(the)e(startup)f(\014les)h(to)g(disco)m(v)m(er)h +(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 1445 +y(stricted.)630 1604 y Ft(shift_verbose)1110 1714 y Fu(If)g(this)g(is)g +(set,)j(the)d Ft(shift)f Fu(builtin)h(prin)m(ts)f(an)h(error)g(message) +i(when)d(the)1110 1823 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m +(b)s(er)e(of)h(p)s(ositional)i(parameters.)630 1983 y +Ft(sourcepath)1110 2092 y Fu(If)22 b(set,)j(the)e Ft(source)e +Fu(builtin)h(uses)g(the)h(v)-5 b(alue)23 b(of)g Ft(PATH)e +Fu(to)j(\014nd)d(the)h(directory)1110 2202 y(con)m(taining)29 +b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m(t.)40 +b(This)27 b(option)h(is)f(enabled)1110 2311 y(b)m(y)j(default.)630 +2471 y Ft(xpg_echo)96 b Fu(If)31 b(set,)h(the)g Ft(echo)e Fu(builtin)h(expands)f(bac)m(kslash-escap)s(e)j(sequences)f(b)m(y)f -(de-)1110 1654 y(fault.)630 1813 y(The)c(return)f(status)i(when)f -(listing)h(options)g(is)f(zero)i(if)e(all)i Fr(optnames)i -Fu(are)d(enabled,)g(non-)630 1923 y(zero)40 b(otherwise.)66 -b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f -(status)h(is)g(zero)630 2032 y(unless)30 b(an)g Fr(optname)36 -b Fu(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)150 -2273 y Fs(4.4)68 b(Sp)t(ecial)45 b(Builtins)150 2433 -y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e Fm(posix)g -Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e(commands)g -(as)h Fl(sp)-5 b(e-)150 2542 y(cial)p Fu(.)47 b(When)33 -b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g(sp)s -(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150 -2652 y(commands)e(in)g(three)h(resp)s(ects:)199 2786 +(de-)1110 2580 y(fault.)150 2821 y Fs(4.4)68 b(Sp)t(ecial)45 +b(Builtins)150 2980 y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e +Fm(posix)g Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e +(commands)g(as)h Fl(sp)-5 b(e-)150 3090 y(cial)p Fu(.)47 +b(When)33 b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g +(sp)s(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150 +3200 y(commands)e(in)g(three)h(resp)s(ects:)199 3334 y(1.)61 b(Sp)s(ecial)31 b(builtins)e(are)i(found)e(b)s(efore)h(shell)h -(functions)f(during)f(command)h(lo)s(okup.)199 2921 y(2.)61 +(functions)f(during)f(command)h(lo)s(okup.)199 3469 y(2.)61 b(If)30 b(a)h(sp)s(ecial)g(builtin)f(returns)f(an)h(error)g(status,)h -(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 3055 +(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 3603 y(3.)61 b(Assignmen)m(t)30 b(statemen)m(ts)h(preceding)f(the)f(command) g(sta)m(y)i(in)e(e\013ect)i(in)e(the)h(shell)f(en)m(vironmen)m(t)330 -3165 y(after)i(the)f(command)h(completes.)275 3324 y(When)36 +3713 y(after)i(the)f(command)h(completes.)275 3872 y(When)36 b(Bash)g(is)h(not)f(executing)i(in)e Fm(posix)f Fu(mo)s(de,)j(these)f (builtins)f(b)s(eha)m(v)m(e)h(no)f(di\013eren)m(tly)h(than)150 -3434 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41 +3982 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41 b(The)30 b(Bash)g Fm(posix)g Fu(mo)s(de)g(is)g(describ)s(ed)f(in)h -(Section)h(6.11)150 3543 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(101.)275 -3678 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390 -3812 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f -(readonly)f(return)h(set)390 3922 y(shift)g(trap)h(unset)p +(Section)h(6.11)150 4091 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(101.)275 +4226 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390 +4360 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f +(readonly)f(return)h(set)390 4470 y(shift)g(trap)h(unset)p eop end %%Page: 73 79 TeXDict begin 73 78 bop 3659 -116 a Fu(73)150 299 y Fp(5)80 @@ -14040,74 +14054,74 @@ TeXDict begin 82 87 bop 150 -116 a Fu(Chapter)30 b(5:)41 b(Shell)30 b(V)-8 b(ariables)2459 b(82)150 299 y Ft(LC_NUMERIC)630 408 y Fu(This)30 b(v)-5 b(ariable)31 b(determines)f(the)h(lo)s(cale)h (category)g(used)e(for)g(n)m(um)m(b)s(er)f(formatting.)150 -565 y Ft(LC_TIME)144 b Fu(This)25 b(v)-5 b(ariable)26 +573 y Ft(LC_TIME)144 b Fu(This)25 b(v)-5 b(ariable)26 b(determines)g(the)g(lo)s(cale)h(category)h(used)d(for)g(data)h(and)f -(time)i(formatting.)150 722 y Ft(LINENO)192 b Fu(The)32 +(time)i(formatting.)150 737 y Ft(LINENO)192 b Fu(The)32 b(line)h(n)m(um)m(b)s(er)e(in)i(the)f(script)h(or)f(shell)h(function)f (curren)m(tly)h(executing.)49 b(If)32 b Ft(LINENO)630 -831 y Fu(is)e(unset,)h(it)g(loses)g(its)f(sp)s(ecial)h(prop)s(erties,)f +847 y Fu(is)e(unset,)h(it)g(loses)g(its)f(sp)s(ecial)h(prop)s(erties,)f (ev)m(en)h(if)g(it)g(is)f(subsequen)m(tly)g(reset.)150 -988 y Ft(LINES)240 b Fu(Used)43 b(b)m(y)g(the)g Ft(select)e +1011 y Ft(LINES)240 b Fu(Used)43 b(b)m(y)g(the)g Ft(select)e Fu(command)i(to)g(determine)g(the)g(column)g(length)g(for)g(prin)m -(ting)630 1097 y(selection)c(lists.)63 b(Automatically)41 +(ting)630 1121 y(selection)c(lists.)63 b(Automatically)41 b(set)d(if)f(the)h Ft(checkwinsize)d Fu(option)j(is)f(enabled)h(\(see) -630 1207 y(Section)44 b(4.3.2)h([The)e(Shopt)g(Builtin],)k(page)d +630 1230 y(Section)44 b(4.3.2)h([The)e(Shopt)g(Builtin],)k(page)d (66\),)k(or)43 b(in)g(an)g(in)m(teractiv)m(e)j(shell)e(up)s(on)630 -1316 y(receipt)31 b(of)g(a)g Ft(SIGWINCH)p Fu(.)150 1473 +1340 y(receipt)31 b(of)g(a)g Ft(SIGWINCH)p Fu(.)150 1504 y Ft(MACHTYPE)96 b Fu(A)26 b(string)g(that)h(fully)f(describ)s(es)f (the)h(system)g(t)m(yp)s(e)h(on)f(whic)m(h)f(Bash)i(is)f(executing,)i -(in)e(the)630 1583 y(standard)k Fm(gnu)g Fr(cpu-compan)m(y-system)h -Fu(format.)150 1739 y Ft(MAILCHECK)630 1849 y Fu(Ho)m(w)d(often)g(\(in) +(in)e(the)630 1614 y(standard)k Fm(gnu)g Fr(cpu-compan)m(y-system)h +Fu(format.)150 1778 y Ft(MAILCHECK)630 1888 y Fu(Ho)m(w)d(often)g(\(in) g(seconds\))g(that)g(the)f(shell)h(should)f(c)m(hec)m(k)i(for)e(mail)h -(in)f(the)h(\014les)g(sp)s(eci\014ed)630 1958 y(in)i(the)h +(in)f(the)h(\014les)g(sp)s(eci\014ed)630 1998 y(in)i(the)h Ft(MAILPATH)e Fu(or)i Ft(MAIL)e Fu(v)-5 b(ariables.)43 b(The)30 b(default)h(is)f(60)i(seconds.)42 b(When)30 -b(it)h(is)g(time)630 2068 y(to)37 b(c)m(hec)m(k)h(for)e(mail,)j(the)e +b(it)h(is)g(time)630 2107 y(to)37 b(c)m(hec)m(k)h(for)e(mail,)j(the)e (shell)f(do)s(es)g(so)h(b)s(efore)f(displa)m(ying)h(the)f(primary)g -(prompt.)57 b(If)630 2178 y(this)37 b(v)-5 b(ariable)38 +(prompt.)57 b(If)630 2217 y(this)37 b(v)-5 b(ariable)38 b(is)f(unset,)h(or)f(set)h(to)g(a)f(v)-5 b(alue)38 b(that)f(is)g(not)h -(a)f(n)m(um)m(b)s(er)f(greater)i(than)f(or)630 2287 y(equal)31 +(a)f(n)m(um)m(b)s(er)f(greater)i(than)f(or)630 2326 y(equal)31 b(to)g(zero,)g(the)g(shell)g(disables)f(mail)h(c)m(hec)m(king.)150 -2444 y Ft(MAPFILE)144 b Fu(An)35 b(arra)m(y)h(v)-5 b(ariable)36 +2491 y Ft(MAPFILE)144 b Fu(An)35 b(arra)m(y)h(v)-5 b(ariable)36 b(created)g(to)h(hold)e(the)g(text)i(read)e(b)m(y)g(the)h -Ft(mapfile)d Fu(builtin)i(when)630 2553 y(no)30 b(v)-5 -b(ariable)31 b(name)g(is)f(supplied.)150 2710 y Ft(OLDPWD)192 +Ft(mapfile)d Fu(builtin)i(when)630 2600 y(no)30 b(v)-5 +b(ariable)31 b(name)g(is)f(supplied.)150 2765 y Ft(OLDPWD)192 b Fu(The)30 b(previous)g(w)m(orking)g(directory)h(as)g(set)g(b)m(y)f -(the)h Ft(cd)e Fu(builtin.)150 2866 y Ft(OPTERR)192 b +(the)h Ft(cd)e Fu(builtin.)150 2929 y Ft(OPTERR)192 b Fu(If)35 b(set)i(to)f(the)h(v)-5 b(alue)36 b(1,)i(Bash)e(displa)m(ys)g (error)f(messages)i(generated)g(b)m(y)f(the)g Ft(getopts)630 -2976 y Fu(builtin)30 b(command.)150 3133 y Ft(OSTYPE)192 +3039 y Fu(builtin)30 b(command.)150 3203 y Ft(OSTYPE)192 b Fu(A)30 b(string)h(describing)f(the)g(op)s(erating)h(system)g(Bash)f -(is)h(running)d(on.)150 3289 y Ft(PIPESTATUS)630 3399 +(is)h(running)d(on.)150 3367 y Ft(PIPESTATUS)630 3477 y Fu(An)23 b(arra)m(y)h(v)-5 b(ariable)24 b(\(see)h(Section)f(6.7)h ([Arra)m(ys],)g(page)f(95\))h(con)m(taining)g(a)f(list)g(of)g(exit)g -(sta-)630 3508 y(tus)h(v)-5 b(alues)27 b(from)e(the)h(pro)s(cesses)g +(sta-)630 3587 y(tus)h(v)-5 b(alues)27 b(from)e(the)h(pro)s(cesses)g (in)f(the)h(most-recen)m(tly-executed)j(foreground)c(pip)s(eline)630 -3618 y(\(whic)m(h)30 b(ma)m(y)h(con)m(tain)h(only)f(a)f(single)h -(command\).)150 3774 y Ft(POSIXLY_CORRECT)630 3884 y +3696 y(\(whic)m(h)30 b(ma)m(y)h(con)m(tain)h(only)f(a)f(single)h +(command\).)150 3861 y Ft(POSIXLY_CORRECT)630 3970 y Fu(If)h(this)g(v)-5 b(ariable)34 b(is)e(in)g(the)h(en)m(vironmen)m(t)g (when)e(Bash)i(starts,)g(the)g(shell)g(en)m(ters)g Fm(posix)630 -3994 y Fu(mo)s(de)46 b(\(see)h(Section)g(6.11)g([Bash)g(POSIX)e(Mo)s +4080 y Fu(mo)s(de)46 b(\(see)h(Section)g(6.11)g([Bash)g(POSIX)e(Mo)s (de],)50 b(page)d(101\))h(b)s(efore)e(reading)g(the)630 -4103 y(startup)38 b(\014les,)j(as)e(if)g(the)g Ft(--posix)d +4189 y(startup)38 b(\014les,)j(as)e(if)g(the)g Ft(--posix)d Fu(in)m(v)m(o)s(cation)41 b(option)e(had)f(b)s(een)g(supplied.)64 -b(If)39 b(it)g(is)630 4213 y(set)31 b(while)f(the)h(shell)f(is)h +b(If)39 b(it)g(is)630 4299 y(set)31 b(while)f(the)h(shell)f(is)h (running,)e(Bash)h(enables)h Fm(posix)f Fu(mo)s(de,)g(as)g(if)h(the)f -(command)870 4346 y Ft(set)47 b(-o)g(posix)630 4479 y +(command)870 4436 y Ft(set)47 b(-o)g(posix)630 4573 y Fu(had)33 b(b)s(een)g(executed.)51 b(When)33 b(the)h(shell)f(en)m(ters) h Fm(posix)f Fu(mo)s(de,)h(it)g(sets)g(this)g(v)-5 b(ariable)34 -b(if)630 4589 y(it)d(w)m(as)g(not)f(already)h(set.)150 -4745 y Ft(PPID)288 b Fu(The)30 b(pro)s(cess)g Fm(id)g +b(if)630 4682 y(it)d(w)m(as)g(not)f(already)h(set.)150 +4847 y Ft(PPID)288 b Fu(The)30 b(pro)s(cess)g Fm(id)g Fu(of)h(the)f(shell's)h(paren)m(t)g(pro)s(cess.)40 b(This)30 -b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150 4902 y -Ft(PROMPT_COMMANDS)630 5011 y Fu(If)38 b(this)g(arra)m(y)h(v)-5 -b(ariable)39 b(is)f(set,)j(the)e(v)-5 b(alue)39 b(of)f(eac)m(h)h(set)g -(elemen)m(t)h(is)e(in)m(terpreted)h(as)g(a)630 5121 y(command)31 -b(to)g(execute)h(b)s(efore)e(prin)m(ting)h(the)g(primary)f(prompt)g(\() -p Ft($PS1)p Fu(\).)41 b(If)30 b(this)h(is)g(not)630 5230 -y(set,)36 b(but)e Ft(PROMPT_COMMAND)d Fu(is)j(set)h(to)h(a)f(v)-5 -b(alue,)36 b(its)f(v)-5 b(alue)35 b(is)f(used)g(as)h(a)g(command)f(to) -630 5340 y(execute)e(instead.)p eop end +b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150 5011 y +Ft(PROMPT_COMMAND)630 5121 y Fu(If)23 b(this)h(v)-5 b(ariable)24 +b(is)g(set,)i(and)d(is)h(an)f(arra)m(y)-8 b(,)27 b(the)d(v)-5 +b(alue)24 b(of)g(eac)m(h)g(set)h(elemen)m(t)g(is)f(in)m(terpreted)630 +5230 y(as)29 b(a)g(command)f(to)i(execute)g(b)s(efore)e(prin)m(ting)h +(the)g(primary)f(prompt)f(\()p Ft($PS1)p Fu(\).)40 b(If)28 +b(this)h(is)630 5340 y(set)c(but)f(not)g(an)h(arra)m(y)g(v)-5 +b(ariable,)26 b(its)f(v)-5 b(alue)25 b(is)f(used)g(as)h(a)f(command)g +(to)i(execute)f(instead.)p eop end %%Page: 83 89 TeXDict begin 83 88 bop 150 -116 a Fu(Chapter)30 b(5:)41 b(Shell)30 b(V)-8 b(ariables)2459 b(83)150 299 y Ft(PROMPT_DIRTRIM)630 @@ -15870,8 +15884,14 @@ b(If)30 b(the)f(shell)h(compatibilit)m(y)i(lev)m(el)f(is)f(set)g(to)h (d)f(from)g(bash-5.0)h(and)f(previous)g(v)m(ersions,)i(so)e(seeding)h (the)g(random)810 2446 y(n)m(um)m(b)s(er)36 b(generator)j(b)m(y)e (assigning)h(a)g(v)-5 b(alue)38 b(to)g Ft(RANDOM)e Fu(will)i(pro)s -(duce)e(the)i(same)810 2555 y(sequence)31 b(as)f(in)g(bash-5.0)p -eop end +(duce)e(the)i(same)810 2555 y(sequence)31 b(as)f(in)g(bash-5.0)705 +2690 y Fq(\017)60 b Fu(If)22 b(the)g(command)g(hash)f(table)i(is)f +(empt)m(y)-8 b(,)25 b(Bash)d(v)m(ersions)g(prior)g(to)h(bash-5.1)f +(prin)m(ted)810 2800 y(an)29 b(informational)i(message)g(to)f(that)g +(e\013ect,)h(ev)m(en)g(when)d(pro)s(ducing)g(output)h(that)810 +2909 y(can)40 b(b)s(e)g(reused)f(as)h(input.)69 b(Bash-5.1)42 +b(suppresses)c(that)j(message)g(when)e(the)i Ft(-l)810 +3019 y Fu(option)31 b(is)f(supplied.)p eop end %%Page: 107 113 TeXDict begin 107 112 bop 3614 -116 a Fu(107)150 299 y Fp(7)80 b(Job)54 b(Con)l(trol)150 518 y Fu(This)25 @@ -16604,27 +16624,28 @@ y(v)-5 b(alue)26 b(greater)h(than)e(zero,)j(common)e(pre\014xes)e y(replaced)k(with)f(an)g(ellipsis)h(when)e(displa)m(ying)i(p)s(ossible) f(completions.)630 2217 y Ft(completion-query-items)1110 2326 y Fu(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h -(that)g(determines)f(when)f(the)i(user)1110 2436 y(is)i(ask)m(ed)h -(whether)f(the)h(list)g(of)f(p)s(ossibilities)h(should)e(b)s(e)h -(displa)m(y)m(ed.)41 b(If)29 b(the)1110 2545 y(n)m(um)m(b)s(er)d(of)h -(p)s(ossible)f(completions)i(is)f(greater)h(than)e(this)h(v)-5 -b(alue,)28 b(Readline)1110 2655 y(will)f(ask)g(the)f(user)g(whether)g -(or)g(not)h(he)f(wishes)g(to)i(view)e(them;)i(otherwise,)1110 -2765 y(they)d(are)f(simply)g(listed.)40 b(This)23 b(v)-5 -b(ariable)25 b(m)m(ust)g(b)s(e)e(set)i(to)g(an)g(in)m(teger)g(v)-5 -b(alue)1110 2874 y(greater)26 b(than)f(or)f(equal)i(to)f(0.)40 -b(A)24 b(negativ)m(e)j(v)-5 b(alue)26 b(means)e(Readline)i(should)1110 -2984 y(nev)m(er)31 b(ask.)41 b(The)29 b(default)i(limit)g(is)g -Ft(100)p Fu(.)630 3162 y Ft(convert-meta)1110 3271 y -Fu(If)22 b(set)g(to)h(`)p Ft(on)p Fu(',)h(Readline)f(will)f(con)m(v)m -(ert)i(c)m(haracters)f(with)f(the)g(eigh)m(th)h(bit)f(set)1110 -3381 y(to)33 b(an)e Fm(asci)r(i)h Fu(k)m(ey)h(sequence)f(b)m(y)g -(stripping)f(the)h(eigh)m(th)h(bit)f(and)f(pre\014xing)1110 -3491 y(an)24 b Ft(ESC)g Fu(c)m(haracter,)j(con)m(v)m(erting)f(them)f -(to)g(a)g(meta-pre\014xed)f(k)m(ey)h(sequence.)1110 3600 -y(The)i(default)h(v)-5 b(alue)28 b(is)f(`)p Ft(on)p Fu(',)i(but)d(will) -i(b)s(e)f(set)h(to)g(`)p Ft(off)p Fu(')g(if)f(the)h(lo)s(cale)h(is)f -(one)1110 3710 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)630 +(that)g(determines)f(when)f(the)i(user)1110 2436 y(is)43 +b(ask)m(ed)g(whether)f(the)g(list)h(of)g(p)s(ossibilities)g(should)f(b) +s(e)g(displa)m(y)m(ed.)77 b(If)1110 2545 y(the)29 b(n)m(um)m(b)s(er)f +(of)h(p)s(ossible)g(completions)h(is)f(greater)h(than)f(or)g(equal)g +(to)h(this)1110 2655 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g +(whether)f(or)h(not)g(the)g(user)f(wishes)g(to)i(view)1110 +2765 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 +b(This)31 b(v)-5 b(ariable)33 b(m)m(ust)e(b)s(e)g(set)1110 +2874 y(to)39 b(an)f(in)m(teger)i(v)-5 b(alue)39 b(greater)g(than)f(or)h +(equal)g(to)g(0.)65 b(A)38 b(negativ)m(e)i(v)-5 b(alue)1110 +2984 y(means)30 b(Readline)h(should)f(nev)m(er)g(ask.)41 +b(The)30 b(default)h(limit)g(is)f Ft(100)p Fu(.)630 3162 +y Ft(convert-meta)1110 3271 y Fu(If)22 b(set)g(to)h(`)p +Ft(on)p Fu(',)h(Readline)f(will)f(con)m(v)m(ert)i(c)m(haracters)f(with) +f(the)g(eigh)m(th)h(bit)f(set)1110 3381 y(to)33 b(an)e +Fm(asci)r(i)h Fu(k)m(ey)h(sequence)f(b)m(y)g(stripping)f(the)h(eigh)m +(th)h(bit)f(and)f(pre\014xing)1110 3491 y(an)24 b Ft(ESC)g +Fu(c)m(haracter,)j(con)m(v)m(erting)f(them)f(to)g(a)g(meta-pre\014xed)f +(k)m(ey)h(sequence.)1110 3600 y(The)i(default)h(v)-5 +b(alue)28 b(is)f(`)p Ft(on)p Fu(',)i(but)d(will)i(b)s(e)f(set)h(to)g(`) +p Ft(off)p Fu(')g(if)f(the)h(lo)s(cale)h(is)f(one)1110 +3710 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)630 3888 y Ft(disable-completion)1110 3998 y Fu(If)k(set)h(to)h(`)p Ft(On)p Fu(',)g(Readline)f(will)g(inhibit)f(w)m(ord)h(completion.)60 b(Completion)1110 4107 y(c)m(haracters)28 b(will)e(b)s(e)f(inserted)h @@ -17196,9 +17217,9 @@ y($endif)390 3477 y(#)i(use)g(a)h(visible)e(bell)g(if)h(one)g(is)h (convert-meta)d(off)390 4573 y(#)j(display)f(characters)f(with)i(the)g (eighth)f(bit)h(set)g(directly)390 4682 y(#)g(rather)g(than)f(as)h (meta-prefixed)e(characters)390 4792 y(set)i(output-meta)e(on)390 -5011 y(#)i(if)h(there)e(are)h(more)g(than)f(150)h(possible)f -(completions)e(for)390 5121 y(#)j(a)h(word,)e(ask)h(the)g(user)g(if)g -(he)g(wants)f(to)i(see)f(all)f(of)i(them)390 5230 y(set)f +5011 y(#)i(if)h(there)e(are)h(150)g(or)g(more)g(possible)e(completions) +g(for)i(a)g(word,)390 5121 y(#)g(ask)g(whether)f(or)h(not)g(the)g(user) +g(wants)f(to)h(see)g(all)g(of)g(them)390 5230 y(set)g (completion-query-items)42 b(150)p eop end %%Page: 127 133 TeXDict begin 127 132 bop 150 -116 a Fu(Chapter)30 b(8:)41 @@ -17263,1201 +17284,1216 @@ i(the)e(same)i(ph)m(ysical)f(screen)g(column)f(on)h(the)f(next)h(ph)m (ysical)h(line)g(or)f(if)g(the)h(length)f(of)h(the)f(curren)m(t)g (Readline)630 737 y(line)k(is)f(not)h(greater)g(than)f(the)h(length)g (of)f(the)h(prompt)e(plus)h(the)g(screen)h(width.)150 -893 y Ft(clear-display)c(\(M-C-l\))630 1003 y Fu(Clear)33 +916 y Ft(clear-display)c(\(M-C-l\))630 1026 y Fu(Clear)33 b(the)g(screen)g(and,)h(if)e(p)s(ossible,)i(the)f(terminal's)g -(scrollbac)m(k)i(bu\013er,)e(then)f(redra)m(w)630 1112 +(scrollbac)m(k)i(bu\013er,)e(then)f(redra)m(w)630 1136 y(the)f(curren)m(t)f(line,)h(lea)m(ving)h(the)e(curren)m(t)h(line)f(at) -h(the)g(top)g(of)f(the)h(screen.)150 1268 y Ft(clear-screen)c(\(C-l\)) -630 1378 y Fu(Clear)35 b(the)f(screen,)i(then)e(redra)m(w)g(the)h +h(the)g(top)g(of)f(the)h(screen.)150 1315 y Ft(clear-screen)c(\(C-l\)) +630 1424 y Fu(Clear)35 b(the)f(screen,)i(then)e(redra)m(w)g(the)h (curren)m(t)f(line,)i(lea)m(ving)g(the)f(curren)m(t)f(line)h(at)g(the) -630 1488 y(top)c(of)f(the)h(screen.)150 1644 y Ft(redraw-current-line) -25 b(\(\))630 1753 y Fu(Refresh)30 b(the)g(curren)m(t)h(line.)41 -b(By)30 b(default,)h(this)f(is)h(un)m(b)s(ound.)150 1949 +630 1534 y(top)c(of)f(the)h(screen.)150 1713 y Ft(redraw-current-line) +25 b(\(\))630 1823 y Fu(Refresh)30 b(the)g(curren)m(t)h(line.)41 +b(By)30 b(default,)h(this)f(is)h(un)m(b)s(ound.)150 2041 y Fk(8.4.2)63 b(Commands)42 b(F)-10 b(or)41 b(Manipulating)h(The)f -(History)150 2119 y Ft(accept-line)27 b(\(Newline)h(or)i(Return\))630 -2229 y Fu(Accept)25 b(the)e(line)h(regardless)g(of)f(where)g(the)h +(History)150 2223 y Ft(accept-line)27 b(\(Newline)h(or)i(Return\))630 +2333 y Fu(Accept)25 b(the)e(line)h(regardless)g(of)f(where)g(the)h (cursor)e(is.)39 b(If)23 b(this)g(line)h(is)f(non-empt)m(y)-8 -b(,)26 b(add)c(it)630 2338 y(to)27 b(the)f(history)g(list)h(according)g +b(,)26 b(add)c(it)630 2442 y(to)27 b(the)f(history)g(list)h(according)g (to)g(the)f(setting)i(of)e(the)g Ft(HISTCONTROL)d Fu(and)j -Ft(HISTIGNORE)630 2448 y Fu(v)-5 b(ariables.)42 b(If)30 +Ft(HISTIGNORE)630 2552 y Fu(v)-5 b(ariables.)42 b(If)30 b(this)h(line)g(is)g(a)g(mo)s(di\014ed)e(history)i(line,)g(then)f -(restore)i(the)f(history)f(line)h(to)630 2558 y(its)g(original)g -(state.)150 2714 y Ft(previous-history)26 b(\(C-p\))630 -2823 y Fu(Mo)m(v)m(e)32 b(`bac)m(k')g(through)e(the)g(history)h(list,)g -(fetc)m(hing)g(the)g(previous)f(command.)150 2979 y Ft(next-history)d -(\(C-n\))630 3089 y Fu(Mo)m(v)m(e)32 b(`forw)m(ard')f(through)e(the)i +(restore)i(the)f(history)f(line)h(to)630 2662 y(its)g(original)g +(state.)150 2841 y Ft(previous-history)26 b(\(C-p\))630 +2950 y Fu(Mo)m(v)m(e)32 b(`bac)m(k')g(through)e(the)g(history)h(list,)g +(fetc)m(hing)g(the)g(previous)f(command.)150 3129 y Ft(next-history)d +(\(C-n\))630 3239 y Fu(Mo)m(v)m(e)32 b(`forw)m(ard')f(through)e(the)i (history)f(list,)i(fetc)m(hing)f(the)g(next)f(command.)150 -3245 y Ft(beginning-of-history)25 b(\(M-<\))630 3354 +3418 y Ft(beginning-of-history)25 b(\(M-<\))630 3528 y Fu(Mo)m(v)m(e)32 b(to)g(the)e(\014rst)g(line)g(in)h(the)f(history)-8 -b(.)150 3510 y Ft(end-of-history)26 b(\(M->\))630 3620 +b(.)150 3707 y Ft(end-of-history)26 b(\(M->\))630 3816 y Fu(Mo)m(v)m(e)32 b(to)g(the)e(end)g(of)g(the)h(input)e(history)-8 b(,)31 b(i.e.,)h(the)f(line)f(curren)m(tly)h(b)s(eing)f(en)m(tered.)150 -3776 y Ft(reverse-search-history)24 b(\(C-r\))630 3886 +3995 y Ft(reverse-search-history)24 b(\(C-r\))630 4105 y Fu(Searc)m(h)31 b(bac)m(kw)m(ard)h(starting)g(at)g(the)f(curren)m(t)g (line)g(and)g(mo)m(ving)h(`up')e(through)h(the)g(his-)630 -3995 y(tory)g(as)f(necessary)-8 b(.)42 b(This)29 b(is)i(an)f(incremen)m -(tal)i(searc)m(h.)150 4151 y Ft(forward-search-history)24 -b(\(C-s\))630 4261 y Fu(Searc)m(h)44 b(forw)m(ard)f(starting)h(at)h +4215 y(tory)26 b(as)h(necessary)-8 b(.)40 b(This)25 b(is)i(an)f +(incremen)m(tal)h(searc)m(h.)40 b(This)25 b(command)h(sets)h(the)f +(region)630 4324 y(to)31 b(the)g(matc)m(hed)g(text)g(and)f(activ)-5 +b(ates)33 b(the)d(mark.)150 4503 y Ft(forward-search-history)24 +b(\(C-s\))630 4613 y Fu(Searc)m(h)44 b(forw)m(ard)f(starting)h(at)h (the)e(curren)m(t)h(line)g(and)f(mo)m(ving)h(`do)m(wn')g(through)f(the) -630 4370 y(history)30 b(as)h(necessary)-8 b(.)41 b(This)30 -b(is)g(an)h(incremen)m(tal)g(searc)m(h.)150 4526 y Ft -(non-incremental-reverse-)o(sear)o(ch-h)o(ist)o(ory)24 -b(\(M-p\))630 4636 y Fu(Searc)m(h)31 b(bac)m(kw)m(ard)h(starting)g(at)g +630 4723 y(history)38 b(as)g(necessary)-8 b(.)65 b(This)38 +b(is)g(an)g(incremen)m(tal)h(searc)m(h.)65 b(This)37 +b(command)h(sets)h(the)630 4832 y(region)31 b(to)g(the)g(matc)m(hed)g +(text)g(and)f(activ)-5 b(ates)33 b(the)d(mark.)150 5011 +y Ft(non-incremental-reverse-)o(sear)o(ch-h)o(ist)o(ory)24 +b(\(M-p\))630 5121 y Fu(Searc)m(h)31 b(bac)m(kw)m(ard)h(starting)g(at)g (the)f(curren)m(t)g(line)g(and)g(mo)m(ving)h(`up')e(through)h(the)g -(his-)630 4746 y(tory)36 b(as)g(necessary)h(using)e(a)i(non-incremen)m +(his-)630 5230 y(tory)36 b(as)g(necessary)h(using)e(a)i(non-incremen)m (tal)g(searc)m(h)f(for)g(a)g(string)g(supplied)f(b)m(y)h(the)630 -4855 y(user.)k(The)30 b(searc)m(h)h(string)f(ma)m(y)h(matc)m(h)g(an)m -(ywhere)g(in)f(a)h(history)f(line.)150 5011 y Ft -(non-incremental-forward-)o(sear)o(ch-h)o(ist)o(ory)24 -b(\(M-n\))630 5121 y Fu(Searc)m(h)44 b(forw)m(ard)f(starting)h(at)h -(the)e(curren)m(t)h(line)g(and)f(mo)m(ving)h(`do)m(wn')g(through)f(the) -630 5230 y(history)27 b(as)f(necessary)i(using)e(a)h(non-incremen)m -(tal)g(searc)m(h)h(for)e(a)h(string)g(supplied)e(b)m(y)i(the)630 -5340 y(user.)40 b(The)30 b(searc)m(h)h(string)f(ma)m(y)h(matc)m(h)g(an) -m(ywhere)g(in)f(a)h(history)f(line.)p eop end +5340 y(user.)k(The)30 b(searc)m(h)h(string)f(ma)m(y)h(matc)m(h)g(an)m +(ywhere)g(in)f(a)h(history)f(line.)p eop end %%Page: 129 135 TeXDict begin 129 134 bop 150 -116 a Fu(Chapter)30 b(8:)41 b(Command)29 b(Line)i(Editing)2062 b(129)150 299 y Ft -(history-search-forward)24 b(\(\))630 408 y Fu(Searc)m(h)42 -b(forw)m(ard)f(through)f(the)i(history)f(for)g(the)h(string)f(of)h(c)m -(haracters)h(b)s(et)m(w)m(een)f(the)630 518 y(start)36 -b(of)h(the)f(curren)m(t)f(line)i(and)e(the)h(p)s(oin)m(t.)58 -b(The)35 b(searc)m(h)i(string)e(m)m(ust)h(matc)m(h)h(at)g(the)630 -628 y(b)s(eginning)32 b(of)g(a)h(history)g(line.)47 b(This)32 -b(is)h(a)f(non-incremen)m(tal)i(searc)m(h.)48 b(By)33 -b(default,)g(this)630 737 y(command)d(is)h(un)m(b)s(ound.)150 -938 y Ft(history-search-backward)24 b(\(\))630 1048 y -Fu(Searc)m(h)35 b(bac)m(kw)m(ard)g(through)f(the)h(history)g(for)g(the) -f(string)h(of)g(c)m(haracters)h(b)s(et)m(w)m(een)g(the)630 -1157 y(start)g(of)h(the)f(curren)m(t)f(line)i(and)e(the)h(p)s(oin)m(t.) +(non-incremental-forward-)o(sear)o(ch-h)o(ist)o(ory)24 +b(\(M-n\))630 408 y Fu(Searc)m(h)44 b(forw)m(ard)f(starting)h(at)h(the) +e(curren)m(t)h(line)g(and)f(mo)m(ving)h(`do)m(wn')g(through)f(the)630 +518 y(history)27 b(as)f(necessary)i(using)e(a)h(non-incremen)m(tal)g +(searc)m(h)h(for)e(a)h(string)g(supplied)e(b)m(y)i(the)630 +628 y(user.)40 b(The)30 b(searc)m(h)h(string)f(ma)m(y)h(matc)m(h)g(an)m +(ywhere)g(in)f(a)h(history)f(line.)150 784 y Ft(history-search-forward) +24 b(\(\))630 894 y Fu(Searc)m(h)42 b(forw)m(ard)f(through)f(the)i +(history)f(for)g(the)h(string)f(of)h(c)m(haracters)h(b)s(et)m(w)m(een)f +(the)630 1003 y(start)36 b(of)h(the)f(curren)m(t)f(line)i(and)e(the)h +(p)s(oin)m(t.)58 b(The)35 b(searc)m(h)i(string)e(m)m(ust)h(matc)m(h)h +(at)g(the)630 1113 y(b)s(eginning)32 b(of)g(a)h(history)g(line.)47 +b(This)32 b(is)h(a)f(non-incremen)m(tal)i(searc)m(h.)48 +b(By)33 b(default,)g(this)630 1223 y(command)d(is)h(un)m(b)s(ound.)150 +1379 y Ft(history-search-backward)24 b(\(\))630 1489 +y Fu(Searc)m(h)35 b(bac)m(kw)m(ard)g(through)f(the)h(history)g(for)g +(the)f(string)h(of)g(c)m(haracters)h(b)s(et)m(w)m(een)g(the)630 +1598 y(start)g(of)h(the)f(curren)m(t)f(line)i(and)e(the)h(p)s(oin)m(t.) 58 b(The)35 b(searc)m(h)i(string)e(m)m(ust)h(matc)m(h)h(at)g(the)630 -1267 y(b)s(eginning)32 b(of)g(a)h(history)g(line.)47 +1708 y(b)s(eginning)32 b(of)g(a)h(history)g(line.)47 b(This)32 b(is)h(a)f(non-incremen)m(tal)i(searc)m(h.)48 -b(By)33 b(default,)g(this)630 1377 y(command)d(is)h(un)m(b)s(ound.)150 -1577 y Ft(history-substring-search)o(-for)o(ward)24 b(\(\))630 -1687 y Fu(Searc)m(h)42 b(forw)m(ard)f(through)f(the)i(history)f(for)g +b(By)33 b(default,)g(this)630 1817 y(command)d(is)h(un)m(b)s(ound.)150 +1974 y Ft(history-substring-search)o(-for)o(ward)24 b(\(\))630 +2084 y Fu(Searc)m(h)42 b(forw)m(ard)f(through)f(the)i(history)f(for)g (the)h(string)f(of)h(c)m(haracters)h(b)s(et)m(w)m(een)f(the)630 -1797 y(start)29 b(of)g(the)g(curren)m(t)g(line)g(and)f(the)h(p)s(oin)m +2193 y(start)29 b(of)g(the)g(curren)m(t)g(line)g(and)f(the)h(p)s(oin)m (t.)40 b(The)29 b(searc)m(h)g(string)g(ma)m(y)g(matc)m(h)h(an)m(ywhere) -630 1906 y(in)i(a)h(history)g(line.)47 b(This)32 b(is)g(a)h +630 2303 y(in)i(a)h(history)g(line.)47 b(This)32 b(is)g(a)h (non-incremen)m(tal)h(searc)m(h.)47 b(By)33 b(default,)h(this)e -(command)630 2016 y(is)e(un)m(b)s(ound.)150 2217 y Ft +(command)630 2412 y(is)e(un)m(b)s(ound.)150 2569 y Ft (history-substring-search)o(-bac)o(kwar)o(d)24 b(\(\))630 -2326 y Fu(Searc)m(h)35 b(bac)m(kw)m(ard)g(through)f(the)h(history)g +2679 y Fu(Searc)m(h)35 b(bac)m(kw)m(ard)g(through)f(the)h(history)g (for)g(the)f(string)h(of)g(c)m(haracters)h(b)s(et)m(w)m(een)g(the)630 -2436 y(start)29 b(of)g(the)g(curren)m(t)g(line)g(and)f(the)h(p)s(oin)m +2788 y(start)29 b(of)g(the)g(curren)m(t)g(line)g(and)f(the)h(p)s(oin)m (t.)40 b(The)29 b(searc)m(h)g(string)g(ma)m(y)g(matc)m(h)h(an)m(ywhere) -630 2545 y(in)i(a)h(history)g(line.)47 b(This)32 b(is)g(a)h +630 2898 y(in)i(a)h(history)g(line.)47 b(This)32 b(is)g(a)h (non-incremen)m(tal)h(searc)m(h.)47 b(By)33 b(default,)h(this)e -(command)630 2655 y(is)e(un)m(b)s(ound.)150 2856 y Ft(yank-nth-arg)d -(\(M-C-y\))630 2966 y Fu(Insert)37 b(the)g(\014rst)f(argumen)m(t)i(to)f +(command)630 3007 y(is)e(un)m(b)s(ound.)150 3164 y Ft(yank-nth-arg)d +(\(M-C-y\))630 3273 y Fu(Insert)37 b(the)g(\014rst)f(argumen)m(t)i(to)f (the)h(previous)e(command)h(\(usually)g(the)g(second)g(w)m(ord)630 -3075 y(on)32 b(the)g(previous)f(line\))i(at)f(p)s(oin)m(t.)46 +3383 y(on)32 b(the)g(previous)f(line\))i(at)f(p)s(oin)m(t.)46 b(With)32 b(an)g(argumen)m(t)g Fr(n)p Fu(,)g(insert)g(the)g -Fr(n)p Fu(th)f(w)m(ord)g(from)630 3185 y(the)k(previous)f(command)h +Fr(n)p Fu(th)f(w)m(ord)g(from)630 3493 y(the)k(previous)f(command)h (\(the)g(w)m(ords)g(in)f(the)h(previous)g(command)f(b)s(egin)h(with)f -(w)m(ord)630 3294 y(0\).)69 b(A)40 b(negativ)m(e)h(argumen)m(t)f +(w)m(ord)630 3602 y(0\).)69 b(A)40 b(negativ)m(e)h(argumen)m(t)f (inserts)g(the)f Fr(n)p Fu(th)g(w)m(ord)g(from)g(the)h(end)f(of)h(the)f -(previous)630 3404 y(command.)48 b(Once)33 b(the)g(argumen)m(t)h +(previous)630 3712 y(command.)48 b(Once)33 b(the)g(argumen)m(t)h Fr(n)e Fu(is)h(computed,)h(the)f(argumen)m(t)g(is)g(extracted)i(as)e -(if)630 3513 y(the)e(`)p Ft(!)p Fj(n)p Fu(')f(history)g(expansion)g -(had)g(b)s(een)g(sp)s(eci\014ed.)150 3714 y Ft(yank-last-arg)d(\(M-.)i -(or)h(M-_\))630 3824 y Fu(Insert)k(last)i(argumen)m(t)g(to)g(the)f +(if)630 3821 y(the)e(`)p Ft(!)p Fj(n)p Fu(')f(history)g(expansion)g +(had)g(b)s(een)g(sp)s(eci\014ed.)150 3978 y Ft(yank-last-arg)d(\(M-.)i +(or)h(M-_\))630 4088 y Fu(Insert)k(last)i(argumen)m(t)g(to)g(the)f (previous)f(command)h(\(the)h(last)f(w)m(ord)g(of)g(the)g(previous)630 -3934 y(history)e(en)m(try\).)51 b(With)34 b(a)g(n)m(umeric)g(argumen)m +4197 y(history)e(en)m(try\).)51 b(With)34 b(a)g(n)m(umeric)g(argumen)m (t,)h(b)s(eha)m(v)m(e)f(exactly)h(lik)m(e)g Ft(yank-nth-arg)p -Fu(.)630 4043 y(Successiv)m(e)26 b(calls)g(to)f Ft(yank-last-arg)c +Fu(.)630 4307 y(Successiv)m(e)26 b(calls)g(to)f Ft(yank-last-arg)c Fu(mo)m(v)m(e)27 b(bac)m(k)e(through)f(the)h(history)g(list,)i -(inserting)630 4153 y(the)c(last)g(w)m(ord)f(\(or)h(the)g(w)m(ord)f(sp) +(inserting)630 4416 y(the)c(last)g(w)m(ord)f(\(or)h(the)g(w)m(ord)f(sp) s(eci\014ed)g(b)m(y)g(the)h(argumen)m(t)g(to)g(the)g(\014rst)f(call\))i -(of)f(eac)m(h)h(line)630 4262 y(in)36 b(turn.)58 b(An)m(y)36 +(of)f(eac)m(h)h(line)630 4526 y(in)36 b(turn.)58 b(An)m(y)36 b(n)m(umeric)h(argumen)m(t)f(supplied)g(to)h(these)g(successiv)m(e)g -(calls)h(determines)630 4372 y(the)d(direction)g(to)h(mo)m(v)m(e)g +(calls)h(determines)630 4635 y(the)d(direction)g(to)h(mo)m(v)m(e)g (through)e(the)h(history)-8 b(.)54 b(A)35 b(negativ)m(e)i(argumen)m(t)e -(switc)m(hes)h(the)630 4482 y(direction)23 b(through)g(the)g(history)f +(switc)m(hes)h(the)630 4745 y(direction)23 b(through)g(the)g(history)f (\(bac)m(k)i(or)f(forw)m(ard\).)38 b(The)22 b(history)h(expansion)g -(facilities)630 4591 y(are)28 b(used)f(to)h(extract)h(the)f(last)g +(facilities)630 4855 y(are)28 b(used)f(to)h(extract)h(the)f(last)g (argumen)m(t,)h(as)e(if)h(the)g(`)p Ft(!$)p Fu(')f(history)g(expansion) -h(had)f(b)s(een)630 4701 y(sp)s(eci\014ed.)150 4902 y -Ft(operate-and-get-next)e(\(C-o\))630 5011 y Fu(Accept)30 +h(had)f(b)s(een)630 4964 y(sp)s(eci\014ed.)150 5121 y +Ft(operate-and-get-next)e(\(C-o\))630 5230 y Fu(Accept)30 b(the)g(curren)m(t)e(line)i(for)f(return)f(to)h(the)h(calling)g -(application)h(as)e(if)g(a)h(newline)f(had)630 5121 y(b)s(een)22 +(application)h(as)e(if)g(a)h(newline)f(had)630 5340 y(b)s(een)22 b(en)m(tered,)k(and)d(fetc)m(h)h(the)f(next)g(line)h(relativ)m(e)h(to)f -(the)f(curren)m(t)g(line)h(from)f(the)g(history)630 5230 -y(for)31 b(editing.)43 b(A)31 b(n)m(umeric)f(argumen)m(t,)i(if)f -(supplied,)f(sp)s(eci\014es)h(the)g(history)f(en)m(try)i(to)f(use)630 -5340 y(instead)g(of)f(the)h(curren)m(t)f(line.)p eop +(the)f(curren)m(t)g(line)h(from)f(the)g(history)p eop end %%Page: 130 136 TeXDict begin 130 135 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(130)150 299 y Fk(8.4.3)63 -b(Commands)42 b(F)-10 b(or)41 b(Changing)g(T)-10 b(ext)150 -470 y Fj(end-of-file)27 b Ft(\(usually)h(C-d\))630 580 -y Fu(The)e(c)m(haracter)h(indicating)h(end-of-\014le)e(as)h(set,)g(for) -f(example,)i(b)m(y)e Ft(stty)p Fu(.)39 b(If)25 b(this)h(c)m(harac-)630 -689 y(ter)c(is)g(read)g(when)e(there)i(are)h(no)e(c)m(haracters)j(on)d -(the)h(line,)i(and)d(p)s(oin)m(t)h(is)g(at)h(the)f(b)s(eginning)630 -799 y(of)31 b(the)f(line,)h(Readline)g(in)m(terprets)g(it)g(as)f(the)h -(end)f(of)g(input)f(and)h(returns)f Fm(eof)p Fu(.)150 -957 y Ft(delete-char)e(\(C-d\))630 1067 y Fu(Delete)35 +b(Command)29 b(Line)i(Editing)2062 b(130)630 299 y(for)31 +b(editing.)43 b(A)31 b(n)m(umeric)f(argumen)m(t,)i(if)f(supplied,)f(sp) +s(eci\014es)h(the)g(history)f(en)m(try)i(to)f(use)630 +408 y(instead)g(of)f(the)h(curren)m(t)f(line.)150 605 +y Fk(8.4.3)63 b(Commands)42 b(F)-10 b(or)41 b(Changing)g(T)-10 +b(ext)150 775 y Fj(end-of-file)27 b Ft(\(usually)h(C-d\))630 +885 y Fu(The)e(c)m(haracter)h(indicating)h(end-of-\014le)e(as)h(set,)g +(for)f(example,)i(b)m(y)e Ft(stty)p Fu(.)39 b(If)25 b(this)h(c)m +(harac-)630 995 y(ter)c(is)g(read)g(when)e(there)i(are)h(no)e(c)m +(haracters)j(on)d(the)h(line,)i(and)d(p)s(oin)m(t)h(is)g(at)h(the)f(b)s +(eginning)630 1104 y(of)31 b(the)f(line,)h(Readline)g(in)m(terprets)g +(it)g(as)f(the)h(end)f(of)g(input)f(and)h(returns)f Fm(eof)p +Fu(.)150 1261 y Ft(delete-char)e(\(C-d\))630 1370 y Fu(Delete)35 b(the)f(c)m(haracter)h(at)f(p)s(oin)m(t.)49 b(If)33 b(this)g(function)g -(is)g(b)s(ound)e(to)j(the)g(same)f(c)m(haracter)630 1176 +(is)g(b)s(ound)e(to)j(the)g(same)f(c)m(haracter)630 1480 y(as)e(the)f(tt)m(y)i Fm(eof)d Fu(c)m(haracter,)j(as)f Fj(C-d)e Fu(commonly)i(is,)g(see)g(ab)s(o)m(v)m(e)h(for)e(the)g -(e\013ects.)150 1335 y Ft(backward-delete-char)25 b(\(Rubout\))630 -1444 y Fu(Delete)32 b(the)f(c)m(haracter)g(b)s(ehind)e(the)h(cursor.)40 +(e\013ects.)150 1637 y Ft(backward-delete-char)25 b(\(Rubout\))630 +1746 y Fu(Delete)32 b(the)f(c)m(haracter)g(b)s(ehind)e(the)h(cursor.)40 b(A)30 b(n)m(umeric)g(argumen)m(t)h(means)f(to)h(kill)g(the)630 -1554 y(c)m(haracters)h(instead)e(of)h(deleting)g(them.)150 -1712 y Ft(forward-backward-delete-)o(char)24 b(\(\))630 -1822 y Fu(Delete)40 b(the)f(c)m(haracter)h(under)c(the)j(cursor,)h +1856 y(c)m(haracters)h(instead)e(of)h(deleting)g(them.)150 +2013 y Ft(forward-backward-delete-)o(char)24 b(\(\))630 +2122 y Fu(Delete)40 b(the)f(c)m(haracter)h(under)c(the)j(cursor,)h (unless)d(the)i(cursor)e(is)h(at)h(the)g(end)e(of)i(the)630 -1931 y(line,)33 b(in)e(whic)m(h)g(case)i(the)f(c)m(haracter)h(b)s +2232 y(line,)33 b(in)e(whic)m(h)g(case)i(the)f(c)m(haracter)h(b)s (ehind)d(the)i(cursor)f(is)g(deleted.)46 b(By)32 b(default,)g(this)630 -2041 y(is)e(not)h(b)s(ound)d(to)j(a)g(k)m(ey)-8 b(.)150 -2199 y Ft(quoted-insert)27 b(\(C-q)i(or)h(C-v\))630 2308 +2341 y(is)e(not)h(b)s(ound)d(to)j(a)g(k)m(ey)-8 b(.)150 +2498 y Ft(quoted-insert)27 b(\(C-q)i(or)h(C-v\))630 2608 y Fu(Add)j(the)i(next)f(c)m(haracter)i(t)m(yp)s(ed)e(to)h(the)f(line)h (v)m(erbatim.)53 b(This)33 b(is)i(ho)m(w)f(to)h(insert)f(k)m(ey)630 -2418 y(sequences)d(lik)m(e)g Fj(C-q)p Fu(,)f(for)g(example.)150 -2576 y Ft(self-insert)d(\(a,)j(b,)g(A,)f(1,)h(!,)g(...)o(\))630 -2686 y Fu(Insert)g(y)m(ourself.)150 2844 y Ft(bracketed-paste-begin)25 -b(\(\))630 2954 y Fu(This)f(function)h(is)f(in)m(tended)h(to)h(b)s(e)e +2717 y(sequences)d(lik)m(e)g Fj(C-q)p Fu(,)f(for)g(example.)150 +2874 y Ft(self-insert)d(\(a,)j(b,)g(A,)f(1,)h(!,)g(...)o(\))630 +2983 y Fu(Insert)g(y)m(ourself.)150 3140 y Ft(bracketed-paste-begin)25 +b(\(\))630 3250 y Fu(This)f(function)h(is)f(in)m(tended)h(to)h(b)s(e)e (b)s(ound)f(to)i(the)g Ft(")p Fu(brac)m(k)m(eted)h(paste)p -Ft(")f Fu(escap)s(e)h(sequence)630 3063 y(sen)m(t)38 +Ft(")f Fu(escap)s(e)h(sequence)630 3359 y(sen)m(t)38 b(b)m(y)f(some)h(terminals,)i(and)d(suc)m(h)g(a)h(binding)e(is)i (assigned)f(b)m(y)h(default.)62 b(It)38 b(allo)m(ws)630 -3173 y(Readline)33 b(to)g(insert)g(the)f(pasted)h(text)g(as)g(a)g +3469 y(Readline)33 b(to)g(insert)g(the)f(pasted)h(text)g(as)g(a)g (single)g(unit)f(without)h(treating)h(eac)m(h)f(c)m(har-)630 -3282 y(acter)40 b(as)f(if)g(it)g(had)f(b)s(een)g(read)h(from)f(the)h(k) +3578 y(acter)40 b(as)f(if)g(it)g(had)f(b)s(een)g(read)h(from)f(the)h(k) m(eyb)s(oard.)66 b(The)39 b(c)m(haracters)h(are)f(inserted)630 -3392 y(as)44 b(if)g(eac)m(h)i(one)e(w)m(as)g(b)s(ound)e(to)j +3688 y(as)44 b(if)g(eac)m(h)i(one)e(w)m(as)g(b)s(ound)e(to)j Ft(self-insert)c Fu(instead)j(of)h(executing)g(an)m(y)f(editing)630 -3502 y(commands.)150 3660 y Ft(transpose-chars)26 b(\(C-t\))630 -3769 y Fu(Drag)33 b(the)f(c)m(haracter)h(b)s(efore)f(the)g(cursor)f -(forw)m(ard)h(o)m(v)m(er)h(the)f(c)m(haracter)i(at)e(the)g(cursor,)630 -3879 y(mo)m(ving)k(the)g(cursor)f(forw)m(ard)g(as)g(w)m(ell.)57 -b(If)35 b(the)h(insertion)g(p)s(oin)m(t)f(is)g(at)i(the)e(end)g(of)h -(the)630 3989 y(line,)24 b(then)e(this)g(transp)s(oses)f(the)h(last)h -(t)m(w)m(o)g(c)m(haracters)g(of)f(the)h(line.)38 b(Negativ)m(e)25 -b(argumen)m(ts)630 4098 y(ha)m(v)m(e)32 b(no)e(e\013ect.)150 -4256 y Ft(transpose-words)c(\(M-t\))630 4366 y Fu(Drag)33 -b(the)g(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)g(past)g(the)h(w)m(ord)f -(after)g(p)s(oin)m(t,)i(mo)m(ving)f(p)s(oin)m(t)f(past)g(that)630 -4476 y(w)m(ord)c(as)h(w)m(ell.)41 b(If)27 b(the)i(insertion)f(p)s(oin)m -(t)h(is)f(at)h(the)g(end)e(of)i(the)f(line,)i(this)e(transp)s(oses)g -(the)630 4585 y(last)j(t)m(w)m(o)h(w)m(ords)e(on)g(the)h(line.)150 -4743 y Ft(upcase-word)c(\(M-u\))630 4853 y Fu(Upp)s(ercase)32 -b(the)g(curren)m(t)g(\(or)g(follo)m(wing\))i(w)m(ord.)45 -b(With)32 b(a)g(negativ)m(e)j(argumen)m(t,)e(upp)s(er-)630 -4963 y(case)e(the)g(previous)f(w)m(ord,)g(but)g(do)g(not)h(mo)m(v)m(e)h -(the)e(cursor.)150 5121 y Ft(downcase-word)d(\(M-l\))630 -5230 y Fu(Lo)m(w)m(ercase)c(the)f(curren)m(t)f(\(or)h(follo)m(wing\))i -(w)m(ord.)37 b(With)22 b(a)g(negativ)m(e)i(argumen)m(t,)g(lo)m(w)m -(ercase)630 5340 y(the)31 b(previous)e(w)m(ord,)i(but)e(do)i(not)f(mo)m -(v)m(e)i(the)f(cursor.)p eop end +3798 y(commands.)630 3931 y(Brac)m(k)m(eted)38 b(paste)f(sets)f(the)h +(region)f(\(the)h(c)m(haracters)g(b)s(et)m(w)m(een)g(p)s(oin)m(t)f(and) +g(the)g(mark\))630 4040 y(to)j(the)g(inserted)f(text.)65 +b(It)39 b(uses)f(the)g(concept)h(of)g(an)f Fl(active)i(mark)10 +b Fu(:)57 b(when)38 b(the)g(mark)630 4150 y(is)d(activ)m(e,)k(Readline) +c(redispla)m(y)h(uses)e(the)h(terminal's)h(standout)f(mo)s(de)f(to)i +(denote)g(the)630 4260 y(region.)150 4416 y Ft(transpose-chars)26 +b(\(C-t\))630 4526 y Fu(Drag)33 b(the)f(c)m(haracter)h(b)s(efore)f(the) +g(cursor)f(forw)m(ard)h(o)m(v)m(er)h(the)f(c)m(haracter)i(at)e(the)g +(cursor,)630 4635 y(mo)m(ving)k(the)g(cursor)f(forw)m(ard)g(as)g(w)m +(ell.)57 b(If)35 b(the)h(insertion)g(p)s(oin)m(t)f(is)g(at)i(the)e(end) +g(of)h(the)630 4745 y(line,)24 b(then)e(this)g(transp)s(oses)f(the)h +(last)h(t)m(w)m(o)g(c)m(haracters)g(of)f(the)h(line.)38 +b(Negativ)m(e)25 b(argumen)m(ts)630 4855 y(ha)m(v)m(e)32 +b(no)e(e\013ect.)150 5011 y Ft(transpose-words)c(\(M-t\))630 +5121 y Fu(Drag)33 b(the)g(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)g(past)g +(the)h(w)m(ord)f(after)g(p)s(oin)m(t,)i(mo)m(ving)f(p)s(oin)m(t)f(past) +g(that)630 5230 y(w)m(ord)c(as)h(w)m(ell.)41 b(If)27 +b(the)i(insertion)f(p)s(oin)m(t)h(is)f(at)h(the)g(end)e(of)i(the)f +(line,)i(this)e(transp)s(oses)g(the)630 5340 y(last)j(t)m(w)m(o)h(w)m +(ords)e(on)g(the)h(line.)p eop end %%Page: 131 137 TeXDict begin 131 136 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(131)150 299 y Ft(capitalize-word) -26 b(\(M-c\))630 408 y Fu(Capitalize)d(the)f(curren)m(t)f(\(or)g(follo) -m(wing\))i(w)m(ord.)38 b(With)21 b(a)h(negativ)m(e)h(argumen)m(t,)h -(capitalize)630 518 y(the)31 b(previous)e(w)m(ord,)i(but)e(do)i(not)f -(mo)m(v)m(e)i(the)f(cursor.)150 674 y Ft(overwrite-mode)26 -b(\(\))630 784 y Fu(T)-8 b(oggle)35 b(o)m(v)m(erwrite)g(mo)s(de.)48 +b(Command)29 b(Line)i(Editing)2062 b(131)150 299 y Ft(upcase-word)27 +b(\(M-u\))630 408 y Fu(Upp)s(ercase)32 b(the)g(curren)m(t)g(\(or)g +(follo)m(wing\))i(w)m(ord.)45 b(With)32 b(a)g(negativ)m(e)j(argumen)m +(t,)e(upp)s(er-)630 518 y(case)e(the)g(previous)f(w)m(ord,)g(but)g(do)g +(not)h(mo)m(v)m(e)h(the)e(cursor.)150 665 y Ft(downcase-word)d(\(M-l\)) +630 775 y Fu(Lo)m(w)m(ercase)c(the)f(curren)m(t)f(\(or)h(follo)m +(wing\))i(w)m(ord.)37 b(With)22 b(a)g(negativ)m(e)i(argumen)m(t,)g(lo)m +(w)m(ercase)630 884 y(the)31 b(previous)e(w)m(ord,)i(but)e(do)i(not)f +(mo)m(v)m(e)i(the)f(cursor.)150 1032 y Ft(capitalize-word)26 +b(\(M-c\))630 1141 y Fu(Capitalize)d(the)f(curren)m(t)f(\(or)g(follo)m +(wing\))i(w)m(ord.)38 b(With)21 b(a)h(negativ)m(e)h(argumen)m(t,)h +(capitalize)630 1251 y(the)31 b(previous)e(w)m(ord,)i(but)e(do)i(not)f +(mo)m(v)m(e)i(the)f(cursor.)150 1398 y Ft(overwrite-mode)26 +b(\(\))630 1508 y Fu(T)-8 b(oggle)35 b(o)m(v)m(erwrite)g(mo)s(de.)48 b(With)33 b(an)g(explicit)h(p)s(ositiv)m(e)g(n)m(umeric)f(argumen)m(t,) -h(switc)m(hes)630 893 y(to)22 b(o)m(v)m(erwrite)i(mo)s(de.)37 +h(switc)m(hes)630 1617 y(to)22 b(o)m(v)m(erwrite)i(mo)s(de.)37 b(With)22 b(an)g(explicit)h(non-p)s(ositiv)m(e)f(n)m(umeric)g(argumen)m -(t,)i(switc)m(hes)e(to)630 1003 y(insert)30 b(mo)s(de.)41 +(t,)i(switc)m(hes)e(to)630 1727 y(insert)30 b(mo)s(de.)41 b(This)30 b(command)h(a\013ects)h(only)e Ft(emacs)f Fu(mo)s(de;)i -Ft(vi)f Fu(mo)s(de)g(do)s(es)g(o)m(v)m(erwrite)630 1112 +Ft(vi)f Fu(mo)s(de)g(do)s(es)g(o)m(v)m(erwrite)630 1837 y(di\013eren)m(tly)-8 b(.)42 b(Eac)m(h)31 b(call)h(to)f Ft(readline\(\))c Fu(starts)k(in)f(insert)g(mo)s(de.)630 -1245 y(In)52 b(o)m(v)m(erwrite)h(mo)s(de,)58 b(c)m(haracters)c(b)s +1965 y(In)52 b(o)m(v)m(erwrite)h(mo)s(de,)58 b(c)m(haracters)c(b)s (ound)c(to)j Ft(self-insert)c Fu(replace)k(the)g(text)g(at)630 -1355 y(p)s(oin)m(t)59 b(rather)f(than)h(pushing)e(the)i(text)g(to)h +2075 y(p)s(oin)m(t)59 b(rather)f(than)h(pushing)e(the)i(text)g(to)h (the)f(righ)m(t.)126 b(Characters)59 b(b)s(ound)d(to)630 -1464 y Ft(backward-delete-char)25 b Fu(replace)31 b(the)g(c)m(haracter) -h(b)s(efore)e(p)s(oin)m(t)g(with)g(a)h(space.)630 1597 +2184 y Ft(backward-delete-char)25 b Fu(replace)31 b(the)g(c)m(haracter) +h(b)s(efore)e(p)s(oin)m(t)g(with)g(a)h(space.)630 2313 y(By)g(default,)f(this)h(command)f(is)g(un)m(b)s(ound.)150 -1793 y Fk(8.4.4)63 b(Killing)42 b(And)e(Y)-10 b(anking)150 -1963 y Ft(kill-line)28 b(\(C-k\))630 2073 y Fu(Kill)j(the)f(text)i -(from)e(p)s(oin)m(t)g(to)h(the)g(end)e(of)i(the)f(line.)150 -2229 y Ft(backward-kill-line)25 b(\(C-x)30 b(Rubout\))630 -2338 y Fu(Kill)h(bac)m(kw)m(ard)g(from)e(the)i(cursor)f(to)h(the)f(b)s -(eginning)g(of)h(the)f(curren)m(t)g(line.)150 2494 y -Ft(unix-line-discard)c(\(C-u\))630 2604 y Fu(Kill)31 -b(bac)m(kw)m(ard)g(from)e(the)i(cursor)f(to)h(the)f(b)s(eginning)g(of)h -(the)f(curren)m(t)g(line.)150 2760 y Ft(kill-whole-line)c(\(\))630 -2870 y Fu(Kill)37 b(all)g(c)m(haracters)h(on)f(the)f(curren)m(t)h -(line,)h(no)f(matter)g(where)f(p)s(oin)m(t)h(is.)59 b(By)36 -b(default,)630 2979 y(this)30 b(is)h(un)m(b)s(ound.)150 -3135 y Ft(kill-word)d(\(M-d\))630 3245 y Fu(Kill)i(from)f(p)s(oin)m(t)g -(to)h(the)g(end)e(of)i(the)f(curren)m(t)h(w)m(ord,)f(or)g(if)h(b)s(et)m -(w)m(een)g(w)m(ords,)f(to)h(the)g(end)630 3354 y(of)h(the)f(next)h(w)m -(ord.)40 b(W)-8 b(ord)31 b(b)s(oundaries)e(are)h(the)h(same)g(as)f -Ft(forward-word)p Fu(.)150 3510 y Ft(backward-kill-word)25 -b(\(M-DEL\))630 3620 y Fu(Kill)k(the)g(w)m(ord)g(b)s(ehind)e(p)s(oin)m -(t.)40 b(W)-8 b(ord)29 b(b)s(oundaries)f(are)h(the)g(same)g(as)g -Ft(backward-word)p Fu(.)150 3776 y Ft(shell-kill-word)d(\(M-C-d\))630 -3886 y Fu(Kill)k(from)f(p)s(oin)m(t)g(to)h(the)g(end)e(of)i(the)f +2500 y Fk(8.4.4)63 b(Killing)42 b(And)e(Y)-10 b(anking)150 +2665 y Ft(kill-line)28 b(\(C-k\))630 2775 y Fu(Kill)k(the)f(text)i +(from)d(p)s(oin)m(t)i(to)g(the)f(end)g(of)g(the)h(line.)44 +b(With)31 b(a)h(negativ)m(e)i(n)m(umeric)d(argu-)630 +2885 y(men)m(t,)g(kill)g(bac)m(kw)m(ard)g(from)f(the)g(cursor)g(to)h +(the)g(b)s(eginning)e(of)i(the)g(curren)m(t)f(line.)150 +3032 y Ft(backward-kill-line)25 b(\(C-x)30 b(Rubout\))630 +3141 y Fu(Kill)40 b(bac)m(kw)m(ard)h(from)e(the)h(cursor)g(to)g(the)g +(b)s(eginning)g(of)g(the)g(curren)m(t)f(line.)70 b(With)41 +b(a)630 3251 y(negativ)m(e)47 b(n)m(umeric)e(argumen)m(t,)50 +b(kill)c(forw)m(ard)e(from)h(the)g(cursor)g(to)h(the)f(end)f(of)i(the) +630 3361 y(curren)m(t)30 b(line.)150 3508 y Ft(unix-line-discard)c +(\(C-u\))630 3617 y Fu(Kill)31 b(bac)m(kw)m(ard)g(from)e(the)i(cursor)f +(to)h(the)f(b)s(eginning)g(of)h(the)f(curren)m(t)g(line.)150 +3765 y Ft(kill-whole-line)c(\(\))630 3874 y Fu(Kill)37 +b(all)g(c)m(haracters)h(on)f(the)f(curren)m(t)h(line,)h(no)f(matter)g +(where)f(p)s(oin)m(t)h(is.)59 b(By)36 b(default,)630 +3984 y(this)30 b(is)h(un)m(b)s(ound.)150 4131 y Ft(kill-word)d(\(M-d\)) +630 4241 y Fu(Kill)i(from)f(p)s(oin)m(t)g(to)h(the)g(end)e(of)i(the)f +(curren)m(t)h(w)m(ord,)f(or)g(if)h(b)s(et)m(w)m(een)g(w)m(ords,)f(to)h +(the)g(end)630 4350 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 +b(ord)31 b(b)s(oundaries)e(are)h(the)h(same)g(as)f Ft(forward-word)p +Fu(.)150 4498 y Ft(backward-kill-word)25 b(\(M-DEL\))630 +4607 y Fu(Kill)k(the)g(w)m(ord)g(b)s(ehind)e(p)s(oin)m(t.)40 +b(W)-8 b(ord)29 b(b)s(oundaries)f(are)h(the)g(same)g(as)g +Ft(backward-word)p Fu(.)150 4754 y Ft(shell-kill-word)d(\(M-C-d\))630 +4864 y Fu(Kill)k(from)f(p)s(oin)m(t)g(to)h(the)g(end)e(of)i(the)f (curren)m(t)h(w)m(ord,)f(or)g(if)h(b)s(et)m(w)m(een)g(w)m(ords,)f(to)h -(the)g(end)630 3995 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 +(the)g(end)630 4974 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 b(ord)31 b(b)s(oundaries)e(are)h(the)h(same)g(as)f Ft -(shell-forward-word)p Fu(.)150 4151 y Ft(shell-backward-kill-word)24 -b(\(\))630 4261 y Fu(Kill)e(the)h(w)m(ord)e(b)s(ehind)g(p)s(oin)m(t.)38 +(shell-forward-word)p Fu(.)150 5121 y Ft(shell-backward-kill-word)24 +b(\(\))630 5230 y Fu(Kill)e(the)h(w)m(ord)e(b)s(ehind)g(p)s(oin)m(t.)38 b(W)-8 b(ord)22 b(b)s(oundaries)f(are)h(the)g(same)h(as)f -Ft(shell-backward-)630 4370 y(word)p Fu(.)150 4526 y -Ft(shell-transpose-words)j(\(M-C-t\))630 4636 y Fu(Drag)33 +Ft(shell-backward-)630 5340 y(word)p Fu(.)p eop end +%%Page: 132 138 +TeXDict begin 132 137 bop 150 -116 a Fu(Chapter)30 b(8:)41 +b(Command)29 b(Line)i(Editing)2062 b(132)150 299 y Ft +(shell-transpose-words)25 b(\(M-C-t\))630 408 y Fu(Drag)33 b(the)g(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)g(past)g(the)h(w)m(ord)f (after)g(p)s(oin)m(t,)i(mo)m(ving)f(p)s(oin)m(t)f(past)g(that)630 -4746 y(w)m(ord)c(as)h(w)m(ell.)41 b(If)27 b(the)i(insertion)f(p)s(oin)m +518 y(w)m(ord)c(as)h(w)m(ell.)41 b(If)27 b(the)i(insertion)f(p)s(oin)m (t)h(is)f(at)h(the)g(end)e(of)i(the)f(line,)i(this)e(transp)s(oses)g -(the)630 4855 y(last)j(t)m(w)m(o)h(w)m(ords)d(on)i(the)f(line.)41 +(the)630 628 y(last)j(t)m(w)m(o)h(w)m(ords)d(on)i(the)f(line.)41 b(W)-8 b(ord)31 b(b)s(oundaries)e(are)h(the)h(same)f(as)h -Ft(shell-forward-)630 4965 y(word)e Fu(and)h Ft(shell-backward-word)p -Fu(.)150 5121 y Ft(unix-word-rubout)c(\(C-w\))630 5230 +Ft(shell-forward-)630 737 y(word)e Fu(and)h Ft(shell-backward-word)p +Fu(.)150 897 y Ft(unix-word-rubout)c(\(C-w\))630 1007 y Fu(Kill)32 b(the)g(w)m(ord)f(b)s(ehind)f(p)s(oin)m(t,)i(using)f (white)h(space)g(as)g(a)g(w)m(ord)f(b)s(oundary)-8 b(.)43 -b(The)31 b(killed)630 5340 y(text)g(is)g(sa)m(v)m(ed)g(on)g(the)f -(kill-ring.)p eop end -%%Page: 132 138 -TeXDict begin 132 137 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(132)150 299 y Ft -(unix-filename-rubout)25 b(\(\))630 408 y Fu(Kill)37 -b(the)f(w)m(ord)g(b)s(ehind)f(p)s(oin)m(t,)j(using)e(white)g(space)h -(and)f(the)g(slash)g(c)m(haracter)i(as)f(the)630 518 -y(w)m(ord)30 b(b)s(oundaries.)39 b(The)30 b(killed)h(text)g(is)g(sa)m -(v)m(ed)g(on)g(the)f(kill-ring.)150 673 y Ft(delete-horizontal-space)24 -b(\(\))630 783 y Fu(Delete)33 b(all)e(spaces)g(and)e(tabs)i(around)e(p) -s(oin)m(t.)41 b(By)31 b(default,)f(this)h(is)f(un)m(b)s(ound.)150 -938 y Ft(kill-region)d(\(\))630 1048 y Fu(Kill)k(the)f(text)i(in)e(the) -g(curren)m(t)h(region.)41 b(By)31 b(default,)f(this)h(command)f(is)g -(un)m(b)s(ound.)150 1203 y Ft(copy-region-as-kill)25 -b(\(\))630 1313 y Fu(Cop)m(y)34 b(the)g(text)h(in)f(the)g(region)g(to)h -(the)f(kill)h(bu\013er,)f(so)g(it)h(can)f(b)s(e)f(y)m(ank)m(ed)i(righ)m -(t)f(a)m(w)m(a)m(y)-8 b(.)630 1422 y(By)31 b(default,)f(this)h(command) -f(is)g(un)m(b)s(ound.)150 1578 y Ft(copy-backward-word)25 -b(\(\))630 1687 y Fu(Cop)m(y)38 b(the)h(w)m(ord)f(b)s(efore)g(p)s(oin)m +b(The)31 b(killed)630 1116 y(text)g(is)g(sa)m(v)m(ed)g(on)g(the)f +(kill-ring.)150 1277 y Ft(unix-filename-rubout)25 b(\(\))630 +1386 y Fu(Kill)37 b(the)f(w)m(ord)g(b)s(ehind)f(p)s(oin)m(t,)j(using)e +(white)g(space)h(and)f(the)g(slash)g(c)m(haracter)i(as)f(the)630 +1496 y(w)m(ord)30 b(b)s(oundaries.)39 b(The)30 b(killed)h(text)g(is)g +(sa)m(v)m(ed)g(on)g(the)f(kill-ring.)150 1656 y Ft +(delete-horizontal-space)24 b(\(\))630 1765 y Fu(Delete)33 +b(all)e(spaces)g(and)e(tabs)i(around)e(p)s(oin)m(t.)41 +b(By)31 b(default,)f(this)h(is)f(un)m(b)s(ound.)150 1925 +y Ft(kill-region)d(\(\))630 2035 y Fu(Kill)k(the)f(text)i(in)e(the)g +(curren)m(t)h(region.)41 b(By)31 b(default,)f(this)h(command)f(is)g(un) +m(b)s(ound.)150 2195 y Ft(copy-region-as-kill)25 b(\(\))630 +2305 y Fu(Cop)m(y)34 b(the)g(text)h(in)f(the)g(region)g(to)h(the)f +(kill)h(bu\013er,)f(so)g(it)h(can)f(b)s(e)f(y)m(ank)m(ed)i(righ)m(t)f +(a)m(w)m(a)m(y)-8 b(.)630 2414 y(By)31 b(default,)f(this)h(command)f +(is)g(un)m(b)s(ound.)150 2574 y Ft(copy-backward-word)25 +b(\(\))630 2684 y Fu(Cop)m(y)38 b(the)h(w)m(ord)f(b)s(efore)g(p)s(oin)m (t)g(to)i(the)e(kill)h(bu\013er.)64 b(The)38 b(w)m(ord)g(b)s(oundaries) -f(are)i(the)630 1797 y(same)31 b(as)f Ft(backward-word)p +f(are)i(the)630 2793 y(same)31 b(as)f Ft(backward-word)p Fu(.)38 b(By)30 b(default,)h(this)f(command)g(is)h(un)m(b)s(ound.)150 -1952 y Ft(copy-forward-word)26 b(\(\))630 2062 y Fu(Cop)m(y)31 +2953 y Ft(copy-forward-word)26 b(\(\))630 3063 y Fu(Cop)m(y)31 b(the)g(w)m(ord)g(follo)m(wing)h(p)s(oin)m(t)f(to)h(the)f(kill)h (bu\013er.)42 b(The)30 b(w)m(ord)h(b)s(oundaries)e(are)j(the)630 -2171 y(same)f(as)f Ft(forward-word)p Fu(.)38 b(By)30 +3173 y(same)f(as)f Ft(forward-word)p Fu(.)38 b(By)30 b(default,)h(this)g(command)f(is)g(un)m(b)s(ound.)150 -2327 y Ft(yank)f(\(C-y\))630 2436 y Fu(Y)-8 b(ank)31 +3333 y Ft(yank)f(\(C-y\))630 3442 y Fu(Y)-8 b(ank)31 b(the)f(top)h(of)g(the)f(kill)h(ring)f(in)m(to)i(the)e(bu\013er)g(at)h -(p)s(oin)m(t.)150 2592 y Ft(yank-pop)d(\(M-y\))630 2701 +(p)s(oin)m(t.)150 3602 y Ft(yank-pop)d(\(M-y\))630 3712 y Fu(Rotate)36 b(the)f(kill-ring,)i(and)d(y)m(ank)h(the)f(new)g(top.)54 b(Y)-8 b(ou)35 b(can)g(only)f(do)h(this)f(if)h(the)g(prior)630 -2811 y(command)30 b(is)h Ft(yank)e Fu(or)h Ft(yank-pop)p -Fu(.)150 3006 y Fk(8.4.5)63 b(Sp)s(ecifying)42 b(Numeric)f(Argumen)m -(ts)150 3176 y Ft(digit-argument)26 b(\()p Fj(M-0)p Ft(,)j -Fj(M-1)p Ft(,)h(...)f Fj(M--)p Ft(\))630 3285 y Fu(Add)d(this)h(digit)g +3822 y(command)30 b(is)h Ft(yank)e Fu(or)h Ft(yank-pop)p +Fu(.)150 4021 y Fk(8.4.5)63 b(Sp)s(ecifying)42 b(Numeric)f(Argumen)m +(ts)150 4194 y Ft(digit-argument)26 b(\()p Fj(M-0)p Ft(,)j +Fj(M-1)p Ft(,)h(...)f Fj(M--)p Ft(\))630 4303 y Fu(Add)d(this)h(digit)g (to)h(the)f(argumen)m(t)g(already)h(accum)m(ulating,)h(or)e(start)h(a)f -(new)f(argumen)m(t.)630 3395 y Fj(M--)j Fu(starts)i(a)g(negativ)m(e)i -(argumen)m(t.)150 3550 y Ft(universal-argument)25 b(\(\))630 -3660 y Fu(This)g(is)g(another)h(w)m(a)m(y)g(to)h(sp)s(ecify)e(an)g +(new)f(argumen)m(t.)630 4413 y Fj(M--)j Fu(starts)i(a)g(negativ)m(e)i +(argumen)m(t.)150 4573 y Ft(universal-argument)25 b(\(\))630 +4682 y Fu(This)g(is)g(another)h(w)m(a)m(y)g(to)h(sp)s(ecify)e(an)g (argumen)m(t.)40 b(If)25 b(this)g(command)h(is)f(follo)m(w)m(ed)i(b)m -(y)f(one)630 3770 y(or)k(more)f(digits,)i(optionally)g(with)e(a)h +(y)f(one)630 4792 y(or)k(more)f(digits,)i(optionally)g(with)e(a)h (leading)h(min)m(us)e(sign,)h(those)g(digits)g(de\014ne)f(the)h(ar-)630 -3879 y(gumen)m(t.)41 b(If)28 b(the)i(command)f(is)g(follo)m(w)m(ed)h(b) +4902 y(gumen)m(t.)41 b(If)28 b(the)i(command)f(is)g(follo)m(w)m(ed)h(b) m(y)f(digits,)i(executing)f Ft(universal-argument)630 -3989 y Fu(again)j(ends)e(the)h(n)m(umeric)f(argumen)m(t,)i(but)e(is)h +5011 y Fu(again)j(ends)e(the)h(n)m(umeric)f(argumen)m(t,)i(but)e(is)h (otherwise)g(ignored.)45 b(As)32 b(a)g(sp)s(ecial)h(case,)630 -4098 y(if)g(this)g(command)f(is)h(immediately)h(follo)m(w)m(ed)h(b)m(y) +5121 y(if)g(this)g(command)f(is)h(immediately)h(follo)m(w)m(ed)h(b)m(y) d(a)h(c)m(haracter)i(that)e(is)g(neither)g(a)g(digit)630 -4208 y(nor)41 b(min)m(us)f(sign,)k(the)e(argumen)m(t)f(coun)m(t)h(for)f +5230 y(nor)41 b(min)m(us)f(sign,)k(the)e(argumen)m(t)f(coun)m(t)h(for)f (the)h(next)f(command)g(is)g(m)m(ultiplied)h(b)m(y)630 -4317 y(four.)54 b(The)35 b(argumen)m(t)g(coun)m(t)h(is)f(initially)h -(one,)h(so)e(executing)i(this)e(function)f(the)i(\014rst)630 -4427 y(time)29 b(mak)m(es)h(the)e(argumen)m(t)i(coun)m(t)f(four,)f(a)h -(second)g(time)g(mak)m(es)h(the)e(argumen)m(t)h(coun)m(t)630 -4537 y(sixteen,)i(and)f(so)h(on.)40 b(By)31 b(default,)g(this)f(is)g -(not)h(b)s(ound)d(to)k(a)e(k)m(ey)-8 b(.)150 4732 y Fk(8.4.6)63 -b(Letting)40 b(Readline)h(T)m(yp)s(e)g(F)-10 b(or)42 -b(Y)-10 b(ou)150 4902 y Ft(complete)28 b(\(TAB\))630 -5011 y Fu(A)m(ttempt)c(to)f(p)s(erform)e(completion)j(on)f(the)g(text)g -(b)s(efore)f(p)s(oin)m(t.)39 b(The)22 b(actual)i(completion)630 -5121 y(p)s(erformed)33 b(is)h(application-sp)s(eci\014c.)53 -b(Bash)35 b(attempts)g(completion)g(treating)h(the)e(text)630 -5230 y(as)39 b(a)h(v)-5 b(ariable)39 b(\(if)h(the)f(text)h(b)s(egins)e -(with)h(`)p Ft($)p Fu('\),)j(username)c(\(if)i(the)f(text)h(b)s(egins)e -(with)630 5340 y(`)p Ft(~)p Fu('\),)31 b(hostname)f(\(if)g(the)g(text)h -(b)s(egins)e(with)h(`)p Ft(@)p Fu('\),)h(or)f(command)f(\(including)h -(aliases)i(and)p eop end +5340 y(four.)54 b(The)35 b(argumen)m(t)g(coun)m(t)h(is)f(initially)h +(one,)h(so)e(executing)i(this)e(function)f(the)i(\014rst)p +eop end %%Page: 133 139 TeXDict begin 133 138 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(133)630 299 y(functions\))35 -b(in)f(turn.)53 b(If)34 b(none)g(of)h(these)h(pro)s(duces)d(a)i(matc)m -(h,)i(\014lename)e(completion)h(is)630 408 y(attempted.)150 -573 y Ft(possible-completions)25 b(\(M-?\))630 682 y -Fu(List)35 b(the)g(p)s(ossible)f(completions)i(of)e(the)h(text)h(b)s -(efore)e(p)s(oin)m(t.)54 b(When)34 b(displa)m(ying)h(com-)630 -792 y(pletions,)f(Readline)f(sets)f(the)h(n)m(um)m(b)s(er)e(of)i -(columns)f(used)f(for)i(displa)m(y)f(to)h(the)g(v)-5 -b(alue)33 b(of)630 902 y Ft(completion-display-width)o -Fu(,)g(the)j(v)-5 b(alue)37 b(of)g(the)f(en)m(vironmen)m(t)h(v)-5 -b(ariable)38 b Ft(COLUMNS)p Fu(,)630 1011 y(or)30 b(the)h(screen)f -(width,)g(in)g(that)h(order.)150 1176 y Ft(insert-completions)25 -b(\(M-*\))630 1285 y Fu(Insert)30 b(all)h(completions)h(of)f(the)g -(text)g(b)s(efore)f(p)s(oin)m(t)h(that)g(w)m(ould)f(ha)m(v)m(e)i(b)s -(een)e(generated)630 1395 y(b)m(y)g Ft(possible-completions)p -Fu(.)150 1559 y Ft(menu-complete)d(\(\))630 1669 y Fu(Similar)d(to)g +b(Command)29 b(Line)i(Editing)2062 b(133)630 299 y(time)29 +b(mak)m(es)h(the)e(argumen)m(t)i(coun)m(t)f(four,)f(a)h(second)g(time)g +(mak)m(es)h(the)e(argumen)m(t)h(coun)m(t)630 408 y(sixteen,)i(and)f(so) +h(on.)40 b(By)31 b(default,)g(this)f(is)g(not)h(b)s(ound)d(to)k(a)e(k)m +(ey)-8 b(.)150 603 y Fk(8.4.6)63 b(Letting)40 b(Readline)h(T)m(yp)s(e)g +(F)-10 b(or)42 b(Y)-10 b(ou)150 772 y Ft(complete)28 +b(\(TAB\))630 882 y Fu(A)m(ttempt)c(to)f(p)s(erform)e(completion)j(on)f +(the)g(text)g(b)s(efore)f(p)s(oin)m(t.)39 b(The)22 b(actual)i +(completion)630 991 y(p)s(erformed)33 b(is)h(application-sp)s +(eci\014c.)53 b(Bash)35 b(attempts)g(completion)g(treating)h(the)e +(text)630 1101 y(as)39 b(a)h(v)-5 b(ariable)39 b(\(if)h(the)f(text)h(b) +s(egins)e(with)h(`)p Ft($)p Fu('\),)j(username)c(\(if)i(the)f(text)h(b) +s(egins)e(with)630 1210 y(`)p Ft(~)p Fu('\),)31 b(hostname)f(\(if)g +(the)g(text)h(b)s(egins)e(with)h(`)p Ft(@)p Fu('\),)h(or)f(command)f +(\(including)h(aliases)i(and)630 1320 y(functions\))j(in)f(turn.)53 +b(If)34 b(none)g(of)h(these)h(pro)s(duces)d(a)i(matc)m(h,)i(\014lename) +e(completion)h(is)630 1430 y(attempted.)150 1584 y Ft +(possible-completions)25 b(\(M-?\))630 1694 y Fu(List)35 +b(the)g(p)s(ossible)f(completions)i(of)e(the)h(text)h(b)s(efore)e(p)s +(oin)m(t.)54 b(When)34 b(displa)m(ying)h(com-)630 1803 +y(pletions,)f(Readline)f(sets)f(the)h(n)m(um)m(b)s(er)e(of)i(columns)f +(used)f(for)i(displa)m(y)f(to)h(the)g(v)-5 b(alue)33 +b(of)630 1913 y Ft(completion-display-width)o Fu(,)g(the)j(v)-5 +b(alue)37 b(of)g(the)f(en)m(vironmen)m(t)h(v)-5 b(ariable)38 +b Ft(COLUMNS)p Fu(,)630 2022 y(or)30 b(the)h(screen)f(width,)g(in)g +(that)h(order.)150 2177 y Ft(insert-completions)25 b(\(M-*\))630 +2286 y Fu(Insert)30 b(all)h(completions)h(of)f(the)g(text)g(b)s(efore)f +(p)s(oin)m(t)h(that)g(w)m(ould)f(ha)m(v)m(e)i(b)s(een)e(generated)630 +2396 y(b)m(y)g Ft(possible-completions)p Fu(.)150 2550 +y Ft(menu-complete)d(\(\))630 2660 y Fu(Similar)d(to)g Ft(complete)p Fu(,)f(but)h(replaces)g(the)g(w)m(ord)g(to)g(b)s(e)f -(completed)i(with)e(a)i(single)f(matc)m(h)630 1778 y(from)37 +(completed)i(with)e(a)i(single)f(matc)m(h)630 2770 y(from)37 b(the)h(list)h(of)f(p)s(ossible)f(completions.)64 b(Rep)s(eated)39 -b(execution)g(of)f Ft(menu-complete)630 1888 y Fu(steps)i(through)g +b(execution)g(of)f Ft(menu-complete)630 2879 y Fu(steps)i(through)g (the)g(list)h(of)f(p)s(ossible)g(completions,)k(inserting)c(eac)m(h)i -(matc)m(h)f(in)f(turn.)630 1998 y(A)m(t)e(the)f(end)f(of)h(the)g(list)g +(matc)m(h)f(in)f(turn.)630 2989 y(A)m(t)e(the)f(end)f(of)h(the)g(list)g (of)g(completions,)i(the)e(b)s(ell)g(is)g(rung)f(\(sub)5 -b(ject)36 b(to)i(the)f(setting)630 2107 y(of)f Ft(bell-style)p +b(ject)36 b(to)i(the)f(setting)630 3098 y(of)f Ft(bell-style)p Fu(\))e(and)h(the)h(original)i(text)f(is)f(restored.)57 b(An)36 b(argumen)m(t)h(of)f Fr(n)f Fu(mo)m(v)m(es)i -Fr(n)630 2217 y Fu(p)s(ositions)e(forw)m(ard)f(in)g(the)h(list)h(of)e +Fr(n)630 3208 y Fu(p)s(ositions)e(forw)m(ard)f(in)g(the)h(list)h(of)e (matc)m(hes;)39 b(a)c(negativ)m(e)i(argumen)m(t)e(ma)m(y)g(b)s(e)f -(used)g(to)630 2326 y(mo)m(v)m(e)40 b(bac)m(kw)m(ard)e(through)g(the)g +(used)g(to)630 3318 y(mo)m(v)m(e)40 b(bac)m(kw)m(ard)e(through)g(the)g (list.)65 b(This)38 b(command)g(is)g(in)m(tended)g(to)h(b)s(e)f(b)s -(ound)e(to)630 2436 y Ft(TAB)p Fu(,)30 b(but)f(is)i(un)m(b)s(ound)d(b)m -(y)i(default.)150 2600 y Ft(menu-complete-backward)24 -b(\(\))630 2710 y Fu(Iden)m(tical)36 b(to)g Ft(menu-complete)p +(ound)e(to)630 3427 y Ft(TAB)p Fu(,)30 b(but)f(is)i(un)m(b)s(ound)d(b)m +(y)i(default.)150 3582 y Ft(menu-complete-backward)24 +b(\(\))630 3691 y Fu(Iden)m(tical)36 b(to)g Ft(menu-complete)p Fu(,)d(but)h(mo)m(v)m(es)j(bac)m(kw)m(ard)e(through)f(the)i(list)f(of)g -(p)s(ossible)630 2819 y(completions,)d(as)e(if)h Ft(menu-complete)26 +(p)s(ossible)630 3801 y(completions,)d(as)e(if)h Ft(menu-complete)26 b Fu(had)k(b)s(een)g(giv)m(en)h(a)g(negativ)m(e)i(argumen)m(t.)150 -2984 y Ft(delete-char-or-list)25 b(\(\))630 3093 y Fu(Deletes)41 +3955 y Ft(delete-char-or-list)25 b(\(\))630 4065 y Fu(Deletes)41 b(the)e(c)m(haracter)h(under)e(the)h(cursor)f(if)h(not)g(at)g(the)h(b)s -(eginning)e(or)h(end)f(of)h(the)630 3203 y(line)50 b(\(lik)m(e)h +(eginning)e(or)h(end)f(of)h(the)630 4174 y(line)50 b(\(lik)m(e)h Ft(delete-char)p Fu(\).)96 b(If)49 b(at)h(the)g(end)f(of)h(the)f(line,) -55 b(b)s(eha)m(v)m(es)c(iden)m(tically)g(to)630 3313 +55 b(b)s(eha)m(v)m(es)c(iden)m(tically)g(to)630 4284 y Ft(possible-completions)p Fu(.)35 b(This)30 b(command)g(is)g(un)m(b)s -(ound)e(b)m(y)i(default.)150 3477 y Ft(complete-filename)c(\(M-/\))630 -3587 y Fu(A)m(ttempt)32 b(\014lename)e(completion)i(on)e(the)h(text)g -(b)s(efore)f(p)s(oin)m(t.)150 3751 y Ft(possible-filename-comple)o -(tion)o(s)24 b(\(C-x)30 b(/\))630 3861 y Fu(List)f(the)g(p)s(ossible)f +(ound)e(b)m(y)i(default.)150 4438 y Ft(complete-filename)c(\(M-/\))630 +4548 y Fu(A)m(ttempt)32 b(\014lename)e(completion)i(on)e(the)h(text)g +(b)s(efore)f(p)s(oin)m(t.)150 4702 y Ft(possible-filename-comple)o +(tion)o(s)24 b(\(C-x)30 b(/\))630 4812 y Fu(List)f(the)g(p)s(ossible)f (completions)h(of)g(the)g(text)g(b)s(efore)g(p)s(oin)m(t,)g(treating)h -(it)f(as)g(a)f(\014lename.)150 4025 y Ft(complete-username)e(\(M-~\)) -630 4134 y Fu(A)m(ttempt)32 b(completion)f(on)g(the)f(text)i(b)s(efore) +(it)f(as)g(a)f(\014lename.)150 4966 y Ft(complete-username)e(\(M-~\)) +630 5076 y Fu(A)m(ttempt)32 b(completion)f(on)g(the)f(text)i(b)s(efore) e(p)s(oin)m(t,)g(treating)i(it)f(as)f(a)h(username.)150 -4299 y Ft(possible-username-comple)o(tion)o(s)24 b(\(C-x)30 -b(~\))630 4408 y Fu(List)25 b(the)g(p)s(ossible)g(completions)h(of)f +5230 y Ft(possible-username-comple)o(tion)o(s)24 b(\(C-x)30 +b(~\))630 5340 y Fu(List)25 b(the)g(p)s(ossible)g(completions)h(of)f (the)g(text)h(b)s(efore)f(p)s(oin)m(t,)h(treating)g(it)g(as)f(a)g -(username.)150 4573 y Ft(complete-variable)h(\(M-$\))630 -4682 y Fu(A)m(ttempt)32 b(completion)f(on)g(the)f(text)i(b)s(efore)e(p) -s(oin)m(t,)g(treating)i(it)f(as)f(a)h(shell)g(v)-5 b(ariable.)150 -4847 y Ft(possible-variable-comple)o(tion)o(s)24 b(\(C-x)30 -b($\))630 4956 y Fu(List)42 b(the)g(p)s(ossible)g(completions)h(of)f -(the)g(text)h(b)s(efore)e(p)s(oin)m(t,)46 b(treating)d(it)f(as)g(a)h -(shell)630 5066 y(v)-5 b(ariable.)150 5230 y Ft(complete-hostname)26 -b(\(M-@\))630 5340 y Fu(A)m(ttempt)32 b(completion)f(on)g(the)f(text)i -(b)s(efore)e(p)s(oin)m(t,)g(treating)i(it)f(as)f(a)h(hostname.)p -eop end +(username.)p eop end %%Page: 134 140 TeXDict begin 134 139 bop 150 -116 a Fu(Chapter)30 b(8:)41 b(Command)29 b(Line)i(Editing)2062 b(134)150 299 y Ft -(possible-hostname-comple)o(tion)o(s)24 b(\(C-x)30 b(@\))630 -408 y Fu(List)25 b(the)g(p)s(ossible)f(completions)h(of)g(the)g(text)g -(b)s(efore)g(p)s(oin)m(t,)h(treating)g(it)f(as)f(a)h(hostname.)150 -587 y Ft(complete-command)h(\(M-!\))630 697 y Fu(A)m(ttempt)32 -b(completion)g(on)f(the)g(text)h(b)s(efore)e(p)s(oin)m(t,)h(treating)h -(it)g(as)f(a)g(command)g(name.)630 807 y(Command)46 b(completion)i -(attempts)g(to)f(matc)m(h)h(the)f(text)h(against)g(aliases,)53 -b(reserv)m(ed)630 916 y(w)m(ords,)36 b(shell)g(functions,)h(shell)e -(builtins,)i(and)e(\014nally)g(executable)i(\014lenames,)g(in)e(that) -630 1026 y(order.)150 1205 y Ft(possible-command-complet)o(ions)24 -b(\(C-x)29 b(!\))630 1314 y Fu(List)d(the)h(p)s(ossible)f(completions)h -(of)f(the)h(text)g(b)s(efore)f(p)s(oin)m(t,)h(treating)g(it)g(as)g(a)f -(command)630 1424 y(name.)150 1603 y Ft(dynamic-complete-history)e -(\(M-TAB\))630 1712 y Fu(A)m(ttempt)31 b(completion)h(on)e(the)g(text)h -(b)s(efore)f(p)s(oin)m(t,)g(comparing)h(the)f(text)h(against)h(lines) -630 1822 y(from)e(the)g(history)h(list)g(for)f(p)s(ossible)g -(completion)i(matc)m(hes.)150 2001 y Ft(dabbrev-expand)26 -b(\(\))630 2110 y Fu(A)m(ttempt)i(men)m(u)e(completion)i(on)f(the)g -(text)g(b)s(efore)f(p)s(oin)m(t,)i(comparing)f(the)g(text)h(against)630 -2220 y(lines)j(from)e(the)i(history)f(list)h(for)g(p)s(ossible)e -(completion)j(matc)m(hes.)150 2399 y Ft(complete-into-braces)25 -b(\(M-{\))630 2509 y Fu(P)m(erform)f(\014lename)f(completion)i(and)f +(complete-variable)26 b(\(M-$\))630 408 y Fu(A)m(ttempt)32 +b(completion)f(on)g(the)f(text)i(b)s(efore)e(p)s(oin)m(t,)g(treating)i +(it)f(as)f(a)h(shell)g(v)-5 b(ariable.)150 589 y Ft +(possible-variable-comple)o(tion)o(s)24 b(\(C-x)30 b($\))630 +699 y Fu(List)42 b(the)g(p)s(ossible)g(completions)h(of)f(the)g(text)h +(b)s(efore)e(p)s(oin)m(t,)46 b(treating)d(it)f(as)g(a)h(shell)630 +809 y(v)-5 b(ariable.)150 989 y Ft(complete-hostname)26 +b(\(M-@\))630 1099 y Fu(A)m(ttempt)32 b(completion)f(on)g(the)f(text)i +(b)s(efore)e(p)s(oin)m(t,)g(treating)i(it)f(as)f(a)h(hostname.)150 +1280 y Ft(possible-hostname-comple)o(tion)o(s)24 b(\(C-x)30 +b(@\))630 1390 y Fu(List)25 b(the)g(p)s(ossible)f(completions)h(of)g +(the)g(text)g(b)s(efore)g(p)s(oin)m(t,)h(treating)g(it)f(as)f(a)h +(hostname.)150 1570 y Ft(complete-command)h(\(M-!\))630 +1680 y Fu(A)m(ttempt)32 b(completion)g(on)f(the)g(text)h(b)s(efore)e(p) +s(oin)m(t,)h(treating)h(it)g(as)f(a)g(command)g(name.)630 +1790 y(Command)46 b(completion)i(attempts)g(to)f(matc)m(h)h(the)f(text) +h(against)g(aliases,)53 b(reserv)m(ed)630 1899 y(w)m(ords,)36 +b(shell)g(functions,)h(shell)e(builtins,)i(and)e(\014nally)g +(executable)i(\014lenames,)g(in)e(that)630 2009 y(order.)150 +2190 y Ft(possible-command-complet)o(ions)24 b(\(C-x)29 +b(!\))630 2299 y Fu(List)d(the)h(p)s(ossible)f(completions)h(of)f(the)h +(text)g(b)s(efore)f(p)s(oin)m(t,)h(treating)g(it)g(as)g(a)f(command)630 +2409 y(name.)150 2590 y Ft(dynamic-complete-history)e(\(M-TAB\))630 +2699 y Fu(A)m(ttempt)31 b(completion)h(on)e(the)g(text)h(b)s(efore)f(p) +s(oin)m(t,)g(comparing)h(the)f(text)h(against)h(lines)630 +2809 y(from)e(the)g(history)h(list)g(for)f(p)s(ossible)g(completion)i +(matc)m(hes.)150 2990 y Ft(dabbrev-expand)26 b(\(\))630 +3099 y Fu(A)m(ttempt)i(men)m(u)e(completion)i(on)f(the)g(text)g(b)s +(efore)f(p)s(oin)m(t,)i(comparing)f(the)g(text)h(against)630 +3209 y(lines)j(from)e(the)i(history)f(list)h(for)g(p)s(ossible)e +(completion)j(matc)m(hes.)150 3390 y Ft(complete-into-braces)25 +b(\(M-{\))630 3500 y Fu(P)m(erform)f(\014lename)f(completion)i(and)f (insert)f(the)h(list)g(of)g(p)s(ossible)f(completions)i(enclosed)630 -2618 y(within)34 b(braces)h(so)f(the)h(list)g(is)g(a)m(v)-5 +3609 y(within)34 b(braces)h(so)f(the)h(list)g(is)g(a)m(v)-5 b(ailable)37 b(to)e(the)g(shell)g(\(see)g(Section)h(3.5.1)g([Brace)g -(Ex-)630 2728 y(pansion],)30 b(page)h(23\).)150 2946 -y Fk(8.4.7)63 b(Keyb)s(oard)41 b(Macros)150 3128 y Ft(start-kbd-macro) -26 b(\(C-x)j(\(\))630 3238 y Fu(Begin)i(sa)m(ving)h(the)e(c)m +(Ex-)630 3719 y(pansion],)30 b(page)h(23\).)150 3939 +y Fk(8.4.7)63 b(Keyb)s(oard)41 b(Macros)150 4122 y Ft(start-kbd-macro) +26 b(\(C-x)j(\(\))630 4232 y Fu(Begin)i(sa)m(ving)h(the)e(c)m (haracters)i(t)m(yp)s(ed)e(in)m(to)h(the)g(curren)m(t)f(k)m(eyb)s(oard) -g(macro.)150 3417 y Ft(end-kbd-macro)d(\(C-x)i(\)\))630 -3526 y Fu(Stop)e(sa)m(ving)h(the)g(c)m(haracters)g(t)m(yp)s(ed)f(in)m +g(macro.)150 4413 y Ft(end-kbd-macro)d(\(C-x)i(\)\))630 +4522 y Fu(Stop)e(sa)m(ving)h(the)g(c)m(haracters)g(t)m(yp)s(ed)f(in)m (to)i(the)e(curren)m(t)g(k)m(eyb)s(oard)g(macro)h(and)f(sa)m(v)m(e)i -(the)630 3636 y(de\014nition.)150 3815 y Ft(call-last-kbd-macro)c -(\(C-x)k(e\))630 3924 y Fu(Re-execute)37 b(the)e(last)h(k)m(eyb)s(oard) +(the)630 4632 y(de\014nition.)150 4813 y Ft(call-last-kbd-macro)c +(\(C-x)k(e\))630 4922 y Fu(Re-execute)37 b(the)e(last)h(k)m(eyb)s(oard) f(macro)h(de\014ned,)f(b)m(y)h(making)f(the)g(c)m(haracters)i(in)e(the) -630 4034 y(macro)c(app)s(ear)f(as)g(if)h(t)m(yp)s(ed)f(at)h(the)f(k)m -(eyb)s(oard.)150 4213 y Ft(print-last-kbd-macro)25 b(\(\))630 -4322 y Fu(Prin)m(t)30 b(the)h(last)g(k)m(eb)s(oard)f(macro)h(de\014ned) +630 5032 y(macro)c(app)s(ear)f(as)g(if)h(t)m(yp)s(ed)f(at)h(the)f(k)m +(eyb)s(oard.)150 5213 y Ft(print-last-kbd-macro)25 b(\(\))630 +5322 y Fu(Prin)m(t)30 b(the)h(last)g(k)m(eb)s(oard)f(macro)h(de\014ned) e(in)i(a)f(format)h(suitable)g(for)f(the)h Fr(inputrc)k -Fu(\014le.)150 4541 y Fk(8.4.8)63 b(Some)41 b(Miscellaneous)i(Commands) -150 4723 y Ft(re-read-init-file)26 b(\(C-x)j(C-r\))630 -4832 y Fu(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of)f(the)g -Fr(inputrc)27 b Fu(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h(bindings)d -(or)i(v)-5 b(ariable)630 4942 y(assignmen)m(ts)31 b(found)e(there.)150 -5121 y Ft(abort)g(\(C-g\))630 5230 y Fu(Ab)s(ort)d(the)h(curren)m(t)f -(editing)h(command)f(and)g(ring)h(the)f(terminal's)h(b)s(ell)g(\(sub)5 -b(ject)26 b(to)i(the)630 5340 y(setting)j(of)g Ft(bell-style)p -Fu(\).)p eop end +Fu(\014le.)p eop end %%Page: 135 141 TeXDict begin 135 140 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(135)150 299 y Ft -(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p Fj(x)p -Ft(,)g(...)o(\))630 408 y Fu(If)35 b(the)g(meta\014ed)g(c)m(haracter)i +b(Command)29 b(Line)i(Editing)2062 b(135)150 299 y Fk(8.4.8)63 +b(Some)41 b(Miscellaneous)i(Commands)150 478 y Ft(re-read-init-file)26 +b(\(C-x)j(C-r\))630 587 y Fu(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of)f +(the)g Fr(inputrc)27 b Fu(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h +(bindings)d(or)i(v)-5 b(ariable)630 697 y(assignmen)m(ts)31 +b(found)e(there.)150 870 y Ft(abort)g(\(C-g\))630 979 +y Fu(Ab)s(ort)d(the)h(curren)m(t)f(editing)h(command)f(and)g(ring)h +(the)f(terminal's)h(b)s(ell)g(\(sub)5 b(ject)26 b(to)i(the)630 +1089 y(setting)j(of)g Ft(bell-style)p Fu(\).)150 1262 +y Ft(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p Fj(x)p +Ft(,)g(...)o(\))630 1372 y Fu(If)35 b(the)g(meta\014ed)g(c)m(haracter)i Fr(x)k Fu(is)35 b(upp)s(er)e(case,)k(run)d(the)h(command)g(that)g(is)g -(b)s(ound)e(to)630 518 y(the)g(corresp)s(onding)f(meta\014ed)h(lo)m(w)m -(er)i(case)f(c)m(haracter.)50 b(The)32 b(b)s(eha)m(vior)h(is)g -(unde\014ned)e(if)630 628 y Fr(x)37 b Fu(is)30 b(already)h(lo)m(w)m(er) -h(case.)150 781 y Ft(prefix-meta)27 b(\(ESC\))630 891 -y Fu(Metafy)39 b(the)e(next)h(c)m(haracter)h(t)m(yp)s(ed.)62 +(b)s(ound)e(to)630 1481 y(the)g(corresp)s(onding)f(meta\014ed)h(lo)m(w) +m(er)i(case)f(c)m(haracter.)50 b(The)32 b(b)s(eha)m(vior)h(is)g +(unde\014ned)e(if)630 1591 y Fr(x)37 b Fu(is)30 b(already)h(lo)m(w)m +(er)h(case.)150 1764 y Ft(prefix-meta)27 b(\(ESC\))630 +1873 y Fu(Metafy)39 b(the)e(next)h(c)m(haracter)h(t)m(yp)s(ed.)62 b(This)37 b(is)g(for)h(k)m(eyb)s(oards)f(without)g(a)h(meta)g(k)m(ey)-8 -b(.)630 1000 y(T)m(yping)30 b(`)p Ft(ESC)g(f)p Fu(')g(is)h(equiv)-5 -b(alen)m(t)31 b(to)g(t)m(yping)g Fj(M-f)p Fu(.)150 1154 -y Ft(undo)e(\(C-_)g(or)h(C-x)g(C-u\))630 1263 y Fu(Incremen)m(tal)h +b(.)630 1983 y(T)m(yping)30 b(`)p Ft(ESC)g(f)p Fu(')g(is)h(equiv)-5 +b(alen)m(t)31 b(to)g(t)m(yping)g Fj(M-f)p Fu(.)150 2156 +y Ft(undo)e(\(C-_)g(or)h(C-x)g(C-u\))630 2266 y Fu(Incremen)m(tal)h (undo,)f(separately)h(remem)m(b)s(ered)f(for)g(eac)m(h)i(line.)150 -1417 y Ft(revert-line)27 b(\(M-r\))630 1526 y Fu(Undo)33 +2439 y Ft(revert-line)27 b(\(M-r\))630 2548 y Fu(Undo)33 b(all)h(c)m(hanges)g(made)f(to)h(this)f(line.)49 b(This)32 b(is)h(lik)m(e)i(executing)f(the)f Ft(undo)f Fu(command)630 -1636 y(enough)e(times)h(to)g(get)h(bac)m(k)f(to)g(the)f(b)s(eginning.) -150 1789 y Ft(tilde-expand)d(\(M-&\))630 1899 y Fu(P)m(erform)j(tilde)h -(expansion)g(on)f(the)g(curren)m(t)h(w)m(ord.)150 2052 -y Ft(set-mark)d(\(C-@\))630 2162 y Fu(Set)33 b(the)g(mark)f(to)i(the)f +2658 y(enough)e(times)h(to)g(get)h(bac)m(k)f(to)g(the)f(b)s(eginning.) +150 2831 y Ft(tilde-expand)d(\(M-&\))630 2940 y Fu(P)m(erform)j(tilde)h +(expansion)g(on)f(the)g(curren)m(t)h(w)m(ord.)150 3114 +y Ft(set-mark)d(\(C-@\))630 3223 y Fu(Set)33 b(the)g(mark)f(to)i(the)f (p)s(oin)m(t.)48 b(If)32 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g -(supplied,)f(the)h(mark)g(is)f(set)630 2271 y(to)f(that)g(p)s(osition.) -150 2425 y Ft(exchange-point-and-mark)24 b(\(C-x)29 b(C-x\))630 -2534 y Fu(Sw)m(ap)i(the)g(p)s(oin)m(t)g(with)g(the)g(mark.)43 +(supplied,)f(the)h(mark)g(is)f(set)630 3333 y(to)f(that)g(p)s(osition.) +150 3506 y Ft(exchange-point-and-mark)24 b(\(C-x)29 b(C-x\))630 +3615 y Fu(Sw)m(ap)i(the)g(p)s(oin)m(t)g(with)g(the)g(mark.)43 b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)i(is)f(set)h(to)f(the)h -(sa)m(v)m(ed)630 2644 y(p)s(osition,)f(and)e(the)i(old)g(cursor)e(p)s -(osition)i(is)f(sa)m(v)m(ed)i(as)e(the)h(mark.)150 2798 -y Ft(character-search)26 b(\(C-]\))630 2907 y Fu(A)f(c)m(haracter)h(is) +(sa)m(v)m(ed)630 3725 y(p)s(osition,)f(and)e(the)i(old)g(cursor)e(p)s +(osition)i(is)f(sa)m(v)m(ed)i(as)e(the)h(mark.)150 3898 +y Ft(character-search)26 b(\(C-]\))630 4008 y Fu(A)f(c)m(haracter)h(is) f(read)g(and)f(p)s(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)g(the)f(next)g(o)s -(ccurrence)g(of)g(that)g(c)m(haracter.)630 3017 y(A)30 +(ccurrence)g(of)g(that)g(c)m(haracter.)630 4117 y(A)30 b(negativ)m(e)j(coun)m(t)e(searc)m(hes)g(for)f(previous)g(o)s -(ccurrences.)150 3170 y Ft(character-search-backwar)o(d)24 -b(\(M-C-]\))630 3280 y Fu(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s +(ccurrences.)150 4290 y Ft(character-search-backwar)o(d)24 +b(\(M-C-]\))630 4400 y Fu(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s (oin)m(t)h(is)g(mo)m(v)m(ed)h(to)f(the)g(previous)f(o)s(ccurrence)h(of) -g(that)630 3389 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(coun)m(t)f +g(that)630 4509 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(coun)m(t)f (searc)m(hes)h(for)e(subsequen)m(t)f(o)s(ccurrences.)150 -3543 y Ft(skip-csi-sequence)d(\(\))630 3652 y Fu(Read)i(enough)f(c)m +4682 y Ft(skip-csi-sequence)d(\(\))630 4792 y Fu(Read)i(enough)f(c)m (haracters)h(to)g(consume)f(a)h(m)m(ulti-k)m(ey)h(sequence)f(suc)m(h)f -(as)g(those)h(de\014ned)630 3762 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g +(as)g(those)h(de\014ned)630 4902 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g (and)f(End.)60 b(Suc)m(h)37 b(sequences)g(b)s(egin)g(with)g(a)h(Con)m -(trol)g(Sequence)630 3871 y(Indicator)f(\(CSI\),)f(usually)h(ESC-[.)59 +(trol)g(Sequence)630 5011 y(Indicator)f(\(CSI\),)f(usually)h(ESC-[.)59 b(If)36 b(this)g(sequence)h(is)g(b)s(ound)d(to)k Ft("\\)p -Fu(e[)p Ft(")p Fu(,)g(k)m(eys)f(pro-)630 3981 y(ducing)31 +Fu(e[)p Ft(")p Fu(,)g(k)m(eys)f(pro-)630 5121 y(ducing)31 b(suc)m(h)h(sequences)g(will)h(ha)m(v)m(e)g(no)f(e\013ect)h(unless)e -(explicitly)j(b)s(ound)c(to)i(a)h(readline)630 4091 y(command,)f +(explicitly)j(b)s(ound)c(to)i(a)h(readline)630 5230 y(command,)f (instead)g(of)g(inserting)g(stra)m(y)h(c)m(haracters)g(in)m(to)g(the)f -(editing)h(bu\013er.)44 b(This)31 b(is)630 4200 y(un)m(b)s(ound)d(b)m -(y)i(default,)h(but)f(usually)g(b)s(ound)e(to)j(ESC-[.)150 -4354 y Ft(insert-comment)26 b(\(M-#\))630 4463 y Fu(Without)36 -b(a)g(n)m(umeric)g(argumen)m(t,)h(the)f(v)-5 b(alue)36 -b(of)g(the)g Ft(comment-begin)c Fu(v)-5 b(ariable)36 -b(is)g(in-)630 4573 y(serted)c(at)g(the)g(b)s(eginning)f(of)h(the)f -(curren)m(t)h(line.)45 b(If)31 b(a)h(n)m(umeric)f(argumen)m(t)h(is)g -(supplied,)630 4682 y(this)k(command)h(acts)g(as)g(a)g(toggle:)55 -b(if)37 b(the)f(c)m(haracters)i(at)g(the)e(b)s(eginning)g(of)h(the)g -(line)630 4792 y(do)30 b(not)h(matc)m(h)h(the)f(v)-5 -b(alue)31 b(of)f Ft(comment-begin)p Fu(,)e(the)i(v)-5 -b(alue)31 b(is)g(inserted,)g(otherwise)g(the)630 4902 -y(c)m(haracters)42 b(in)d Ft(comment-begin)e Fu(are)j(deleted)h(from)f -(the)g(b)s(eginning)g(of)g(the)g(line.)71 b(In)630 5011 -y(either)37 b(case,)j(the)e(line)f(is)g(accepted)i(as)e(if)g(a)g -(newline)g(had)g(b)s(een)f(t)m(yp)s(ed.)60 b(The)37 b(default)630 -5121 y(v)-5 b(alue)32 b(of)g Ft(comment-begin)c Fu(causes)k(this)f -(command)h(to)g(mak)m(e)h(the)e(curren)m(t)h(line)g(a)g(shell)630 -5230 y(commen)m(t.)40 b(If)26 b(a)h(n)m(umeric)f(argumen)m(t)h(causes)g -(the)f(commen)m(t)i(c)m(haracter)g(to)f(b)s(e)f(remo)m(v)m(ed,)630 -5340 y(the)31 b(line)f(will)h(b)s(e)f(executed)h(b)m(y)f(the)h(shell.)p +(editing)h(bu\013er.)44 b(This)31 b(is)630 5340 y(un)m(b)s(ound)d(b)m +(y)i(default,)h(but)f(usually)g(b)s(ound)e(to)j(ESC-[.)p eop end %%Page: 136 142 TeXDict begin 136 141 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(136)150 299 y Ft(dump-functions)26 -b(\(\))630 408 y Fu(Prin)m(t)g(all)i(of)e(the)h(functions)f(and)g -(their)g(k)m(ey)h(bindings)e(to)j(the)e(Readline)h(output)f(stream.)630 -518 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g(supplied,)f(the)h +b(Command)29 b(Line)i(Editing)2062 b(136)150 299 y Ft(insert-comment)26 +b(\(M-#\))630 408 y Fu(Without)36 b(a)g(n)m(umeric)g(argumen)m(t,)h +(the)f(v)-5 b(alue)36 b(of)g(the)g Ft(comment-begin)c +Fu(v)-5 b(ariable)36 b(is)g(in-)630 518 y(serted)c(at)g(the)g(b)s +(eginning)f(of)h(the)f(curren)m(t)h(line.)45 b(If)31 +b(a)h(n)m(umeric)f(argumen)m(t)h(is)g(supplied,)630 628 +y(this)k(command)h(acts)g(as)g(a)g(toggle:)55 b(if)37 +b(the)f(c)m(haracters)i(at)g(the)e(b)s(eginning)g(of)h(the)g(line)630 +737 y(do)30 b(not)h(matc)m(h)h(the)f(v)-5 b(alue)31 b(of)f +Ft(comment-begin)p Fu(,)e(the)i(v)-5 b(alue)31 b(is)g(inserted,)g +(otherwise)g(the)630 847 y(c)m(haracters)42 b(in)d Ft(comment-begin)e +Fu(are)j(deleted)h(from)f(the)g(b)s(eginning)g(of)g(the)g(line.)71 +b(In)630 956 y(either)37 b(case,)j(the)e(line)f(is)g(accepted)i(as)e +(if)g(a)g(newline)g(had)g(b)s(een)f(t)m(yp)s(ed.)60 b(The)37 +b(default)630 1066 y(v)-5 b(alue)32 b(of)g Ft(comment-begin)c +Fu(causes)k(this)f(command)h(to)g(mak)m(e)h(the)e(curren)m(t)h(line)g +(a)g(shell)630 1176 y(commen)m(t.)40 b(If)26 b(a)h(n)m(umeric)f +(argumen)m(t)h(causes)g(the)f(commen)m(t)i(c)m(haracter)g(to)f(b)s(e)f +(remo)m(v)m(ed,)630 1285 y(the)31 b(line)f(will)h(b)s(e)f(executed)h(b) +m(y)f(the)h(shell.)150 1443 y Ft(dump-functions)26 b(\(\))630 +1553 y Fu(Prin)m(t)g(all)i(of)e(the)h(functions)f(and)g(their)g(k)m(ey) +h(bindings)e(to)j(the)e(Readline)h(output)f(stream.)630 +1663 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g(supplied,)f(the)h (output)f(is)h(formatted)g(in)f(suc)m(h)h(a)g(w)m(a)m(y)g(that)630 -628 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h Fr(inputrc)k +1772 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h Fr(inputrc)k Fu(\014le.)41 b(This)29 b(command)h(is)h(un)m(b)s(ound)c(b)m(y)k -(default.)150 783 y Ft(dump-variables)26 b(\(\))630 892 -y Fu(Prin)m(t)21 b(all)h(of)g(the)f(settable)i(v)-5 b(ariables)22 -b(and)f(their)g(v)-5 b(alues)22 b(to)g(the)f(Readline)h(output)f -(stream.)630 1002 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g -(supplied,)f(the)h(output)f(is)h(formatted)g(in)f(suc)m(h)h(a)g(w)m(a)m -(y)g(that)630 1112 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h +(default.)150 1931 y Ft(dump-variables)26 b(\(\))630 +2040 y Fu(Prin)m(t)21 b(all)h(of)g(the)f(settable)i(v)-5 +b(ariables)22 b(and)f(their)g(v)-5 b(alues)22 b(to)g(the)f(Readline)h +(output)f(stream.)630 2150 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is) +g(supplied,)f(the)h(output)f(is)h(formatted)g(in)f(suc)m(h)h(a)g(w)m(a) +m(y)g(that)630 2259 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h Fr(inputrc)k Fu(\014le.)41 b(This)29 b(command)h(is)h(un)m(b)s(ound)c -(b)m(y)k(default.)150 1267 y Ft(dump-macros)c(\(\))630 -1377 y Fu(Prin)m(t)34 b(all)g(of)g(the)g(Readline)g(k)m(ey)h(sequences) +(b)m(y)k(default.)150 2418 y Ft(dump-macros)c(\(\))630 +2527 y Fu(Prin)m(t)34 b(all)g(of)g(the)g(Readline)g(k)m(ey)h(sequences) f(b)s(ound)e(to)i(macros)g(and)f(the)h(strings)g(they)630 -1486 y(output.)53 b(If)35 b(a)g(n)m(umeric)f(argumen)m(t)i(is)e +2637 y(output.)53 b(If)35 b(a)g(n)m(umeric)f(argumen)m(t)i(is)e (supplied,)h(the)g(output)g(is)f(formatted)i(in)e(suc)m(h)h(a)630 -1596 y(w)m(a)m(y)c(that)g(it)f(can)g(b)s(e)g(made)g(part)f(of)i(an)e +2746 y(w)m(a)m(y)c(that)g(it)f(can)g(b)s(e)g(made)g(part)f(of)i(an)e Fr(inputrc)35 b Fu(\014le.)41 b(This)29 b(command)h(is)g(un)m(b)s(ound) -d(b)m(y)630 1705 y(default.)150 1861 y Ft(glob-complete-word)e(\(M-g\)) -630 1970 y Fu(The)i(w)m(ord)h(b)s(efore)f(p)s(oin)m(t)h(is)g(treated)h +d(b)m(y)630 2856 y(default.)150 3014 y Ft(glob-complete-word)e(\(M-g\)) +630 3124 y Fu(The)i(w)m(ord)h(b)s(efore)f(p)s(oin)m(t)h(is)g(treated)h (as)f(a)h(pattern)f(for)f(pathname)h(expansion,)g(with)g(an)630 -2080 y(asterisk)d(implicitly)h(app)s(ended.)37 b(This)23 +3233 y(asterisk)d(implicitly)h(app)s(ended.)37 b(This)23 b(pattern)i(is)f(used)g(to)h(generate)h(a)e(list)h(of)g(matc)m(hing)630 -2189 y(\014le)30 b(names)h(for)f(p)s(ossible)g(completions.)150 -2345 y Ft(glob-expand-word)c(\(C-x)j(*\))630 2454 y Fu(The)40 +3343 y(\014le)30 b(names)h(for)f(p)s(ossible)g(completions.)150 +3501 y Ft(glob-expand-word)c(\(C-x)j(*\))630 3611 y Fu(The)40 b(w)m(ord)g(b)s(efore)g(p)s(oin)m(t)h(is)g(treated)g(as)g(a)g(pattern)g -(for)f(pathname)g(expansion,)k(and)630 2564 y(the)c(list)g(of)f(matc)m +(for)f(pathname)g(expansion,)k(and)630 3720 y(the)c(list)g(of)f(matc)m (hing)i(\014le)e(names)g(is)h(inserted,)h(replacing)g(the)e(w)m(ord.)67 -b(If)39 b(a)h(n)m(umeric)630 2673 y(argumen)m(t)31 b(is)f(supplied,)g +b(If)39 b(a)h(n)m(umeric)630 3830 y(argumen)m(t)31 b(is)f(supplied,)g (a)g(`)p Ft(*)p Fu(')h(is)f(app)s(ended)f(b)s(efore)h(pathname)g -(expansion.)150 2829 y Ft(glob-list-expansions)25 b(\(C-x)k(g\))630 -2938 y Fu(The)k(list)h(of)f(expansions)g(that)h(w)m(ould)f(ha)m(v)m(e)h +(expansion.)150 3988 y Ft(glob-list-expansions)25 b(\(C-x)k(g\))630 +4098 y Fu(The)k(list)h(of)f(expansions)g(that)h(w)m(ould)f(ha)m(v)m(e)h (b)s(een)f(generated)h(b)m(y)f Ft(glob-expand-word)630 -3048 y Fu(is)h(displa)m(y)m(ed,)h(and)e(the)h(line)g(is)f(redra)m(wn.) +4208 y Fu(is)h(displa)m(y)m(ed,)h(and)e(the)h(line)g(is)f(redra)m(wn.) 50 b(If)33 b(a)h(n)m(umeric)g(argumen)m(t)g(is)f(supplied,)h(a)g(`)p -Ft(*)p Fu(')630 3157 y(is)c(app)s(ended)f(b)s(efore)h(pathname)g -(expansion.)150 3313 y Ft(display-shell-version)25 b(\(C-x)k(C-v\))630 -3422 y Fu(Displa)m(y)j(v)m(ersion)e(information)h(ab)s(out)f(the)h -(curren)m(t)f(instance)h(of)f(Bash.)150 3577 y Ft(shell-expand-line)c -(\(M-C-e\))630 3687 y Fu(Expand)34 b(the)h(line)h(as)g(the)f(shell)h +Ft(*)p Fu(')630 4317 y(is)c(app)s(ended)f(b)s(efore)h(pathname)g +(expansion.)150 4475 y Ft(display-shell-version)25 b(\(C-x)k(C-v\))630 +4585 y Fu(Displa)m(y)j(v)m(ersion)e(information)h(ab)s(out)f(the)h +(curren)m(t)f(instance)h(of)f(Bash.)150 4743 y Ft(shell-expand-line)c +(\(M-C-e\))630 4853 y Fu(Expand)34 b(the)h(line)h(as)g(the)f(shell)h (do)s(es.)55 b(This)34 b(p)s(erforms)g(alias)i(and)f(history)g -(expansion)630 3797 y(as)f(w)m(ell)g(as)g(all)h(of)e(the)h(shell)g(w)m +(expansion)630 4963 y(as)f(w)m(ell)g(as)g(all)h(of)e(the)h(shell)g(w)m (ord)f(expansions)g(\(see)i(Section)f(3.5)h([Shell)e(Expansions],)630 -3906 y(page)e(22\).)150 4061 y Ft(history-expand-line)25 -b(\(M-^\))630 4171 y Fu(P)m(erform)30 b(history)h(expansion)f(on)g(the) -h(curren)m(t)f(line.)150 4326 y Ft(magic-space)d(\(\))630 -4436 y Fu(P)m(erform)c(history)g(expansion)g(on)g(the)g(curren)m(t)g -(line)g(and)g(insert)g(a)g(space)h(\(see)g(Section)g(9.3)630 -4545 y([History)31 b(In)m(teraction],)i(page)e(148\).)150 -4701 y Ft(alias-expand-line)26 b(\(\))630 4810 y Fu(P)m(erform)i(alias) -i(expansion)e(on)g(the)h(curren)m(t)f(line)h(\(see)g(Section)g(6.6)h -([Aliases],)g(page)f(94\).)150 4966 y Ft(history-and-alias-expand)o -(-lin)o(e)24 b(\(\))630 5075 y Fu(P)m(erform)30 b(history)h(and)e -(alias)j(expansion)e(on)g(the)h(curren)m(t)f(line.)150 -5230 y Ft(insert-last-argument)25 b(\(M-.)k(or)h(M-_\))630 -5340 y Fu(A)g(synon)m(ym)g(for)g Ft(yank-last-arg)p Fu(.)p -eop end +5072 y(page)e(22\).)150 5230 y Ft(history-expand-line)25 +b(\(M-^\))630 5340 y Fu(P)m(erform)30 b(history)h(expansion)f(on)g(the) +h(curren)m(t)f(line.)p eop end %%Page: 137 143 TeXDict begin 137 142 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(137)150 299 y Ft -(edit-and-execute-command)24 b(\(C-x)29 b(C-e\))630 408 -y Fu(In)m(v)m(ok)m(e)34 b(an)f(editor)g(on)g(the)g(curren)m(t)f +b(Command)29 b(Line)i(Editing)2062 b(137)150 299 y Ft(magic-space)27 +b(\(\))630 408 y Fu(P)m(erform)c(history)g(expansion)g(on)g(the)g +(curren)m(t)g(line)g(and)g(insert)g(a)g(space)h(\(see)g(Section)g(9.3) +630 518 y([History)31 b(In)m(teraction],)i(page)e(148\).)150 +663 y Ft(alias-expand-line)26 b(\(\))630 773 y Fu(P)m(erform)i(alias)i +(expansion)e(on)g(the)h(curren)m(t)f(line)h(\(see)g(Section)g(6.6)h +([Aliases],)g(page)f(94\).)150 918 y Ft(history-and-alias-expand)o +(-lin)o(e)24 b(\(\))630 1028 y Fu(P)m(erform)30 b(history)h(and)e +(alias)j(expansion)e(on)g(the)h(curren)m(t)f(line.)150 +1173 y Ft(insert-last-argument)25 b(\(M-.)k(or)h(M-_\))630 +1283 y Fu(A)g(synon)m(ym)g(for)g Ft(yank-last-arg)p Fu(.)150 +1428 y Ft(edit-and-execute-command)24 b(\(C-x)29 b(C-e\))630 +1538 y Fu(In)m(v)m(ok)m(e)34 b(an)f(editor)g(on)g(the)g(curren)m(t)f (command)h(line,)h(and)e(execute)i(the)f(result)g(as)g(shell)630 -518 y(commands.)81 b(Bash)44 b(attempts)h(to)g(in)m(v)m(ok)m(e)h +1647 y(commands.)81 b(Bash)44 b(attempts)h(to)g(in)m(v)m(ok)m(e)h Ft($VISUAL)p Fu(,)f Ft($EDITOR)p Fu(,)h(and)d Ft(emacs)g -Fu(as)h(the)630 628 y(editor,)31 b(in)f(that)h(order.)150 -893 y Fs(8.5)68 b(Readline)47 b(vi)e(Mo)t(de)150 1052 +Fu(as)h(the)630 1757 y(editor,)31 b(in)f(that)h(order.)150 +1983 y Fs(8.5)68 b(Readline)47 b(vi)e(Mo)t(de)150 2143 y Fu(While)32 b(the)g(Readline)g(library)f(do)s(es)g(not)h(ha)m(v)m(e)h (a)f(full)f(set)h(of)g Ft(vi)f Fu(editing)h(functions,)f(it)h(do)s(es)g -(con)m(tain)150 1162 y(enough)i(to)h(allo)m(w)g(simple)f(editing)h(of)f +(con)m(tain)150 2252 y(enough)i(to)h(allo)m(w)g(simple)f(editing)h(of)f (the)g(line.)52 b(The)34 b(Readline)g Ft(vi)g Fu(mo)s(de)f(b)s(eha)m(v) -m(es)i(as)f(sp)s(eci\014ed)f(in)150 1271 y(the)e Fm(posix)e -Fu(standard.)275 1422 y(In)35 b(order)g(to)i(switc)m(h)f(in)m(teractiv) +m(es)i(as)f(sp)s(eci\014ed)f(in)150 2362 y(the)e Fm(posix)e +Fu(standard.)275 2489 y(In)35 b(order)g(to)i(switc)m(h)f(in)m(teractiv) m(ely)j(b)s(et)m(w)m(een)d Ft(emacs)f Fu(and)g Ft(vi)g Fu(editing)h(mo)s(des,)h(use)f(the)g(`)p Ft(set)30 b(-o)150 -1532 y(emacs)p Fu(')43 b(and)h(`)p Ft(set)30 b(-o)f(vi)p +2599 y(emacs)p Fu(')43 b(and)h(`)p Ft(set)30 b(-o)f(vi)p Fu(')44 b(commands)g(\(see)i(Section)f(4.3.1)h([The)e(Set)h(Builtin],)j -(page)e(62\).)83 b(The)150 1641 y(Readline)31 b(default)g(is)f -Ft(emacs)f Fu(mo)s(de.)275 1792 y(When)g(y)m(ou)i(en)m(ter)f(a)h(line)f +(page)e(62\).)83 b(The)150 2709 y(Readline)31 b(default)g(is)f +Ft(emacs)f Fu(mo)s(de.)275 2836 y(When)g(y)m(ou)i(en)m(ter)f(a)h(line)f (in)g Ft(vi)f Fu(mo)s(de,)h(y)m(ou)h(are)f(already)h(placed)f(in)g -(`insertion')g(mo)s(de,)g(as)h(if)f(y)m(ou)150 1902 y(had)f(t)m(yp)s +(`insertion')g(mo)s(de,)g(as)h(if)f(y)m(ou)150 2946 y(had)f(t)m(yp)s (ed)g(an)g(`)p Ft(i)p Fu('.)41 b(Pressing)29 b Ft(ESC)f Fu(switc)m(hes)i(y)m(ou)g(in)m(to)h(`command')e(mo)s(de,)h(where)e(y)m -(ou)i(can)g(edit)g(the)150 2011 y(text)35 b(of)f(the)g(line)g(with)f +(ou)i(can)g(edit)g(the)150 3055 y(text)35 b(of)f(the)g(line)g(with)f (the)h(standard)f Ft(vi)g Fu(mo)m(v)m(emen)m(t)j(k)m(eys,)g(mo)m(v)m(e) -f(to)f(previous)g(history)f(lines)h(with)150 2121 y(`)p +f(to)f(previous)g(history)f(lines)h(with)150 3165 y(`)p Ft(k)p Fu(')d(and)e(subsequen)m(t)h(lines)h(with)f(`)p -Ft(j)p Fu(',)g(and)g(so)h(forth.)150 2386 y Fs(8.6)68 -b(Programmable)47 b(Completion)150 2545 y Fu(When)25 +Ft(j)p Fu(',)g(and)g(so)h(forth.)150 3391 y Fs(8.6)68 +b(Programmable)47 b(Completion)150 3551 y Fu(When)25 b(w)m(ord)g(completion)i(is)f(attempted)g(for)g(an)f(argumen)m(t)h(to)g -(a)g(command)f(for)h(whic)m(h)f(a)h(completion)150 2655 +(a)g(command)f(for)h(whic)m(h)f(a)h(completion)150 3660 y(sp)s(eci\014cation)40 b(\(a)h Fr(compsp)s(ec)6 b Fu(\))39 b(has)h(b)s(een)f(de\014ned)f(using)h(the)h Ft(complete)d -Fu(builtin)j(\(see)g(Section)h(8.7)150 2764 y([Programmable)h +Fu(builtin)j(\(see)g(Section)h(8.7)150 3770 y([Programmable)h (Completion)f(Builtins],)k(page)d(139\),)j(the)c(programmable)g -(completion)i(facilities)150 2874 y(are)31 b(in)m(v)m(ok)m(ed.)275 -3025 y(First,)23 b(the)e(command)g(name)g(is)h(iden)m(ti\014ed.)37 +(completion)i(facilities)150 3880 y(are)31 b(in)m(v)m(ok)m(ed.)275 +4007 y(First,)23 b(the)e(command)g(name)g(is)h(iden)m(ti\014ed.)37 b(If)21 b(a)g(compsp)s(ec)g(has)g(b)s(een)f(de\014ned)g(for)h(that)h -(command,)150 3134 y(the)44 b(compsp)s(ec)g(is)g(used)f(to)h(generate)i +(command,)150 4117 y(the)44 b(compsp)s(ec)g(is)g(used)f(to)h(generate)i (the)e(list)g(of)g(p)s(ossible)g(completions)h(for)e(the)h(w)m(ord.)81 -b(If)44 b(the)150 3244 y(command)36 b(w)m(ord)g(is)g(the)g(empt)m(y)h +b(If)44 b(the)150 4226 y(command)36 b(w)m(ord)g(is)g(the)g(empt)m(y)h (string)f(\(completion)i(attempted)f(at)g(the)g(b)s(eginning)e(of)h(an) -h(empt)m(y)150 3354 y(line\),)30 b(an)m(y)g(compsp)s(ec)f(de\014ned)f +h(empt)m(y)150 4336 y(line\),)30 b(an)m(y)g(compsp)s(ec)f(de\014ned)f (with)h(the)h Ft(-E)e Fu(option)i(to)g Ft(complete)d Fu(is)i(used.)40 b(If)29 b(the)g(command)g(w)m(ord)150 -3463 y(is)e(a)h(full)e(pathname,)i(a)g(compsp)s(ec)e(for)h(the)g(full)g +4445 y(is)e(a)h(full)e(pathname,)i(a)g(compsp)s(ec)e(for)h(the)g(full)g (pathname)g(is)g(searc)m(hed)h(for)f(\014rst.)39 b(If)26 -b(no)h(compsp)s(ec)g(is)150 3573 y(found)22 b(for)g(the)h(full)g +b(no)h(compsp)s(ec)g(is)150 4555 y(found)22 b(for)g(the)h(full)g (pathname,)h(an)f(attempt)h(is)f(made)g(to)g(\014nd)f(a)h(compsp)s(ec)f -(for)h(the)g(p)s(ortion)f(follo)m(wing)150 3682 y(the)34 +(for)h(the)g(p)s(ortion)f(follo)m(wing)150 4665 y(the)34 b(\014nal)g(slash.)53 b(If)34 b(those)g(searc)m(hes)i(do)e(not)g (result)h(in)f(a)g(compsp)s(ec,)h(an)m(y)g(compsp)s(ec)f(de\014ned)f -(with)150 3792 y(the)k Ft(-D)g Fu(option)g(to)h Ft(complete)d +(with)150 4774 y(the)k Ft(-D)g Fu(option)g(to)h Ft(complete)d Fu(is)i(used)g(as)g(the)g(default.)61 b(If)37 b(there)g(is)h(no)f -(default)g(compsp)s(ec,)i(Bash)150 3901 y(attempts)e(alias)h(expansion) +(default)g(compsp)s(ec,)i(Bash)150 4884 y(attempts)e(alias)h(expansion) e(on)g(the)h(command)f(w)m(ord)g(as)h(a)f(\014nal)g(resort,)j(and)c -(attempts)j(to)f(\014nd)e(a)150 4011 y(compsp)s(ec)30 +(attempts)j(to)f(\014nd)e(a)150 4993 y(compsp)s(ec)30 b(for)g(the)h(command)f(w)m(ord)g(from)g(an)m(y)h(successful)f -(expansion)275 4162 y(Once)k(a)g(compsp)s(ec)g(has)g(b)s(een)f(found,)h +(expansion)275 5121 y(Once)k(a)g(compsp)s(ec)g(has)g(b)s(een)f(found,)h (it)h(is)f(used)f(to)i(generate)h(the)e(list)h(of)f(matc)m(hing)h(w)m -(ords.)51 b(If)150 4271 y(a)37 b(compsp)s(ec)f(is)g(not)h(found,)f(the) +(ords.)51 b(If)150 5230 y(a)37 b(compsp)s(ec)f(is)g(not)h(found,)f(the) h(default)f(Bash)h(completion)g(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)f -(Section)g(8.4.6)150 4381 y([Commands)30 b(F)-8 b(or)31 -b(Completion],)g(page)g(132\))h(is)f(p)s(erformed.)275 -4532 y(First,)g(the)g(actions)g(sp)s(eci\014ed)f(b)m(y)h(the)f(compsp)s -(ec)h(are)g(used.)40 b(Only)30 b(matc)m(hes)i(whic)m(h)e(are)h -(pre\014xed)150 4641 y(b)m(y)h(the)f(w)m(ord)h(b)s(eing)f(completed)h -(are)g(returned.)44 b(When)31 b(the)h Ft(-f)f Fu(or)h -Ft(-d)f Fu(option)h(is)f(used)g(for)h(\014lename)150 -4751 y(or)e(directory)h(name)f(completion,)i(the)e(shell)h(v)-5 -b(ariable)31 b Ft(FIGNORE)d Fu(is)i(used)f(to)i(\014lter)g(the)f(matc)m -(hes.)42 b(See)150 4860 y(Section)31 b(5.2)h([Bash)e(V)-8 +(Section)g(8.4.6)150 5340 y([Commands)30 b(F)-8 b(or)31 +b(Completion],)g(page)g(133\))h(is)f(p)s(erformed.)p +eop end +%%Page: 138 144 +TeXDict begin 138 143 bop 150 -116 a Fu(Chapter)30 b(8:)41 +b(Command)29 b(Line)i(Editing)2062 b(138)275 299 y(First,)31 +b(the)g(actions)g(sp)s(eci\014ed)f(b)m(y)h(the)f(compsp)s(ec)h(are)g +(used.)40 b(Only)30 b(matc)m(hes)i(whic)m(h)e(are)h(pre\014xed)150 +408 y(b)m(y)h(the)f(w)m(ord)h(b)s(eing)f(completed)h(are)g(returned.)44 +b(When)31 b(the)h Ft(-f)f Fu(or)h Ft(-d)f Fu(option)h(is)f(used)g(for)h +(\014lename)150 518 y(or)e(directory)h(name)f(completion,)i(the)e +(shell)h(v)-5 b(ariable)31 b Ft(FIGNORE)d Fu(is)i(used)f(to)i(\014lter) +g(the)f(matc)m(hes.)42 b(See)150 628 y(Section)31 b(5.2)h([Bash)e(V)-8 b(ariables],)33 b(page)e(73,)g(for)f(a)h(description)g(of)f -Ft(FIGNORE)p Fu(.)275 5011 y(An)m(y)22 b(completions)h(sp)s(eci\014ed)f +Ft(FIGNORE)p Fu(.)275 769 y(An)m(y)22 b(completions)h(sp)s(eci\014ed)f (b)m(y)g(a)h(\014lename)f(expansion)h(pattern)f(to)h(the)g -Ft(-G)e Fu(option)i(are)g(generated)150 5121 y(next.)41 +Ft(-G)e Fu(option)i(are)g(generated)150 878 y(next.)41 b(The)29 b(w)m(ords)g(generated)h(b)m(y)g(the)g(pattern)f(need)h(not)f (matc)m(h)i(the)f(w)m(ord)f(b)s(eing)g(completed.)41 -b(The)150 5230 y Ft(GLOBIGNORE)29 b Fu(shell)i(v)-5 b(ariable)32 +b(The)150 988 y Ft(GLOBIGNORE)29 b Fu(shell)i(v)-5 b(ariable)32 b(is)g(not)g(used)e(to)i(\014lter)g(the)g(matc)m(hes,)h(but)d(the)i -Ft(FIGNORE)e Fu(shell)h(v)-5 b(ariable)150 5340 y(is)30 -b(used.)p eop end -%%Page: 138 144 -TeXDict begin 138 143 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(138)275 299 y(Next,)39 -b(the)f(string)f(sp)s(eci\014ed)f(as)h(the)g(argumen)m(t)h(to)g(the)f -Ft(-W)f Fu(option)i(is)f(considered.)60 b(The)37 b(string)150 -408 y(is)c(\014rst)e(split)i(using)f(the)h(c)m(haracters)h(in)e(the)h -Ft(IFS)e Fu(sp)s(ecial)j(v)-5 b(ariable)33 b(as)g(delimiters.)48 -b(Shell)32 b(quoting)h(is)150 518 y(honored)f(within)h(the)g(string,)h -(in)f(order)f(to)i(pro)m(vide)f(a)h(mec)m(hanism)f(for)g(the)g(w)m -(ords)g(to)g(con)m(tain)i(shell)150 628 y(metac)m(haracters)e(or)e(c)m -(haracters)i(in)e(the)g(v)-5 b(alue)31 b(of)g Ft(IFS)p -Fu(.)42 b(Eac)m(h)32 b(w)m(ord)e(is)h(then)g(expanded)f(using)h(brace) -150 737 y(expansion,)g(tilde)h(expansion,)f(parameter)g(and)g(v)-5 -b(ariable)32 b(expansion,)f(command)f(substitution,)i(and)150 -847 y(arithmetic)c(expansion,)f(as)g(describ)s(ed)e(ab)s(o)m(v)m(e)i -(\(see)h(Section)f(3.5)g([Shell)g(Expansions],)g(page)g(22\).)40 -b(The)150 956 y(results)23 b(are)h(split)g(using)f(the)h(rules)f -(describ)s(ed)f(ab)s(o)m(v)m(e)j(\(see)g(Section)f(3.5.7)h([W)-8 -b(ord)24 b(Splitting],)i(page)e(32\).)150 1066 y(The)j(results)h(of)f -(the)h(expansion)g(are)g(pre\014x-matc)m(hed)g(against)h(the)f(w)m(ord) -f(b)s(eing)g(completed,)j(and)d(the)150 1176 y(matc)m(hing)k(w)m(ords)f -(b)s(ecome)h(the)g(p)s(ossible)f(completions.)275 1313 -y(After)f(these)g(matc)m(hes)i(ha)m(v)m(e)f(b)s(een)f(generated,)h(an)m -(y)g(shell)f(function)g(or)g(command)g(sp)s(eci\014ed)f(with)150 -1422 y(the)36 b Ft(-F)f Fu(and)g Ft(-C)g Fu(options)h(is)g(in)m(v)m(ok) -m(ed.)59 b(When)35 b(the)h(command)g(or)f(function)h(is)g(in)m(v)m(ok)m -(ed,)i(the)e Ft(COMP_)150 1532 y(LINE)p Fu(,)42 b Ft(COMP_POINT)p +Ft(FIGNORE)e Fu(shell)h(v)-5 b(ariable)150 1097 y(is)30 +b(used.)275 1238 y(Next,)39 b(the)f(string)f(sp)s(eci\014ed)f(as)h(the) +g(argumen)m(t)h(to)g(the)f Ft(-W)f Fu(option)i(is)f(considered.)60 +b(The)37 b(string)150 1348 y(is)c(\014rst)e(split)i(using)f(the)h(c)m +(haracters)h(in)e(the)h Ft(IFS)e Fu(sp)s(ecial)j(v)-5 +b(ariable)33 b(as)g(delimiters.)48 b(Shell)32 b(quoting)h(is)150 +1457 y(honored)f(within)h(the)g(string,)h(in)f(order)f(to)i(pro)m(vide) +f(a)h(mec)m(hanism)f(for)g(the)g(w)m(ords)g(to)g(con)m(tain)i(shell)150 +1567 y(metac)m(haracters)e(or)e(c)m(haracters)i(in)e(the)g(v)-5 +b(alue)31 b(of)g Ft(IFS)p Fu(.)42 b(Eac)m(h)32 b(w)m(ord)e(is)h(then)g +(expanded)f(using)h(brace)150 1677 y(expansion,)g(tilde)h(expansion,)f +(parameter)g(and)g(v)-5 b(ariable)32 b(expansion,)f(command)f +(substitution,)i(and)150 1786 y(arithmetic)c(expansion,)f(as)g(describ) +s(ed)e(ab)s(o)m(v)m(e)i(\(see)h(Section)f(3.5)g([Shell)g(Expansions],)g +(page)g(22\).)40 b(The)150 1896 y(results)23 b(are)h(split)g(using)f +(the)h(rules)f(describ)s(ed)f(ab)s(o)m(v)m(e)j(\(see)g(Section)f(3.5.7) +h([W)-8 b(ord)24 b(Splitting],)i(page)e(32\).)150 2005 +y(The)j(results)h(of)f(the)h(expansion)g(are)g(pre\014x-matc)m(hed)g +(against)h(the)f(w)m(ord)f(b)s(eing)g(completed,)j(and)d(the)150 +2115 y(matc)m(hing)k(w)m(ords)f(b)s(ecome)h(the)g(p)s(ossible)f +(completions.)275 2256 y(After)f(these)g(matc)m(hes)i(ha)m(v)m(e)f(b)s +(een)f(generated,)h(an)m(y)g(shell)f(function)g(or)g(command)g(sp)s +(eci\014ed)f(with)150 2365 y(the)36 b Ft(-F)f Fu(and)g +Ft(-C)g Fu(options)h(is)g(in)m(v)m(ok)m(ed.)59 b(When)35 +b(the)h(command)g(or)f(function)h(is)g(in)m(v)m(ok)m(ed,)i(the)e +Ft(COMP_)150 2475 y(LINE)p Fu(,)42 b Ft(COMP_POINT)p Fu(,)d Ft(COMP_KEY)p Fu(,)i(and)e Ft(COMP_TYPE)f Fu(v)-5 b(ariables)41 b(are)f(assigned)g(v)-5 b(alues)41 b(as)f(describ)s(ed) -150 1641 y(ab)s(o)m(v)m(e)34 b(\(see)g(Section)g(5.2)g([Bash)f(V)-8 +150 2585 y(ab)s(o)m(v)m(e)34 b(\(see)g(Section)g(5.2)g([Bash)f(V)-8 b(ariables],)36 b(page)d(73\).)50 b(If)33 b(a)g(shell)g(function)g(is)g -(b)s(eing)f(in)m(v)m(ok)m(ed,)k(the)150 1751 y Ft(COMP_WORDS)j +(b)s(eing)f(in)m(v)m(ok)m(ed,)k(the)150 2694 y Ft(COMP_WORDS)j Fu(and)i Ft(COMP_CWORD)d Fu(v)-5 b(ariables)42 b(are)g(also)h(set.)74 -b(When)41 b(the)h(function)f(or)h(command)f(is)150 1861 +b(When)41 b(the)h(function)f(or)h(command)f(is)150 2804 y(in)m(v)m(ok)m(ed,)c(the)e(\014rst)f(argumen)m(t)h(\($1\))h(is)e(the)h (name)g(of)f(the)h(command)f(whose)h(argumen)m(ts)f(are)h(b)s(eing)150 -1970 y(completed,)30 b(the)f(second)f(argumen)m(t)h(\($2\))h(is)f(the)g +2913 y(completed,)30 b(the)f(second)f(argumen)m(t)h(\($2\))h(is)f(the)g (w)m(ord)f(b)s(eing)g(completed,)i(and)e(the)h(third)e(argumen)m(t)150 -2080 y(\($3\))40 b(is)f(the)f(w)m(ord)h(preceding)f(the)h(w)m(ord)f(b)s +3023 y(\($3\))40 b(is)f(the)f(w)m(ord)h(preceding)f(the)h(w)m(ord)f(b)s (eing)g(completed)i(on)e(the)h(curren)m(t)f(command)h(line.)65 -b(No)150 2189 y(\014ltering)33 b(of)h(the)f(generated)h(completions)g +b(No)150 3133 y(\014ltering)33 b(of)h(the)f(generated)h(completions)g (against)h(the)e(w)m(ord)g(b)s(eing)f(completed)i(is)g(p)s(erformed;)f -(the)150 2299 y(function)d(or)g(command)h(has)f(complete)i(freedom)e -(in)g(generating)h(the)g(matc)m(hes.)275 2436 y(An)m(y)j(function)h(sp) +(the)150 3242 y(function)d(or)g(command)h(has)f(complete)i(freedom)e +(in)g(generating)h(the)g(matc)m(hes.)275 3383 y(An)m(y)j(function)h(sp) s(eci\014ed)f(with)g Ft(-F)g Fu(is)h(in)m(v)m(ok)m(ed)h(\014rst.)53 b(The)35 b(function)f(ma)m(y)h(use)g(an)m(y)g(of)g(the)g(shell)150 -2545 y(facilities,)50 b(including)44 b(the)h Ft(compgen)d +3493 y(facilities,)50 b(including)44 b(the)h Ft(compgen)d Fu(and)i Ft(compopt)e Fu(builtins)i(describ)s(ed)f(b)s(elo)m(w)h(\(see) -i(Section)f(8.7)150 2655 y([Programmable)31 b(Completion)h(Builtins],)f +i(Section)f(8.7)150 3602 y([Programmable)31 b(Completion)h(Builtins],)f (page)h(139\),)g(to)g(generate)g(the)f(matc)m(hes.)42 -b(It)31 b(m)m(ust)g(put)f(the)150 2765 y(p)s(ossible)g(completions)h +b(It)31 b(m)m(ust)g(put)f(the)150 3712 y(p)s(ossible)g(completions)h (in)f(the)h Ft(COMPREPLY)d Fu(arra)m(y)j(v)-5 b(ariable,)31 -b(one)g(p)s(er)e(arra)m(y)i(elemen)m(t.)275 2902 y(Next,)26 +b(one)g(p)s(er)e(arra)m(y)i(elemen)m(t.)275 3853 y(Next,)26 b(an)m(y)f(command)f(sp)s(eci\014ed)g(with)g(the)h Ft(-C)f Fu(option)h(is)f(in)m(v)m(ok)m(ed)i(in)e(an)g(en)m(vironmen)m(t)h -(equiv)-5 b(alen)m(t)150 3011 y(to)26 b(command)e(substitution.)39 +(equiv)-5 b(alen)m(t)150 3962 y(to)26 b(command)e(substitution.)39 b(It)25 b(should)f(prin)m(t)h(a)g(list)h(of)f(completions,)i(one)e(p)s -(er)f(line,)j(to)f(the)f(standard)150 3121 y(output.)40 +(er)f(line,)j(to)f(the)f(standard)150 4072 y(output.)40 b(Bac)m(kslash)32 b(ma)m(y)f(b)s(e)f(used)g(to)h(escap)s(e)g(a)f -(newline,)h(if)f(necessary)-8 b(.)275 3258 y(After)24 +(newline,)h(if)f(necessary)-8 b(.)275 4213 y(After)24 b(all)i(of)f(the)f(p)s(ossible)g(completions)i(are)f(generated,)i(an)m (y)e(\014lter)g(sp)s(eci\014ed)e(with)i(the)g Ft(-X)e -Fu(option)150 3367 y(is)34 b(applied)g(to)g(the)h(list.)52 +Fu(option)150 4322 y(is)34 b(applied)g(to)g(the)h(list.)52 b(The)33 b(\014lter)h(is)g(a)h(pattern)f(as)g(used)f(for)h(pathname)g -(expansion;)i(a)e(`)p Ft(&)p Fu(')g(in)g(the)150 3477 +(expansion;)i(a)e(`)p Ft(&)p Fu(')g(in)g(the)150 4432 y(pattern)28 b(is)f(replaced)h(with)g(the)f(text)i(of)f(the)f(w)m(ord)h (b)s(eing)f(completed.)40 b(A)28 b(literal)h(`)p Ft(&)p -Fu(')f(ma)m(y)g(b)s(e)f(escap)s(ed)150 3587 y(with)38 +Fu(')f(ma)m(y)g(b)s(e)f(escap)s(ed)150 4542 y(with)38 b(a)h(bac)m(kslash;)k(the)38 b(bac)m(kslash)h(is)g(remo)m(v)m(ed)g(b)s (efore)f(attempting)h(a)g(matc)m(h.)65 b(An)m(y)39 b(completion)150 -3696 y(that)32 b(matc)m(hes)g(the)g(pattern)g(will)f(b)s(e)g(remo)m(v)m +4651 y(that)32 b(matc)m(hes)g(the)g(pattern)g(will)f(b)s(e)g(remo)m(v)m (ed)h(from)f(the)h(list.)44 b(A)32 b(leading)g(`)p Ft(!)p -Fu(')f(negates)i(the)f(pattern;)150 3806 y(in)d(this)g(case)h(an)m(y)g +Fu(')f(negates)i(the)f(pattern;)150 4761 y(in)d(this)g(case)h(an)m(y)g (completion)h(not)e(matc)m(hing)h(the)g(pattern)f(will)h(b)s(e)e(remo)m -(v)m(ed.)42 b(If)29 b(the)g Ft(nocasematch)150 3915 y +(v)m(ed.)42 b(If)29 b(the)g Ft(nocasematch)150 4870 y Fu(shell)k(option)f(\(see)i(the)e(description)g(of)h Ft(shopt)e Fu(in)h(Section)h(4.3.2)h([The)e(Shopt)g(Builtin],)h(page)g -(66\))h(is)150 4025 y(enabled,)d(the)f(matc)m(h)h(is)g(p)s(erformed)e +(66\))h(is)150 4980 y(enabled,)d(the)f(matc)m(h)h(is)g(p)s(erformed)e (without)h(regard)g(to)h(the)g(case)g(of)g(alphab)s(etic)g(c)m -(haracters.)275 4162 y(Finally)-8 b(,)42 b(an)m(y)c(pre\014x)g(and)f +(haracters.)275 5121 y(Finally)-8 b(,)42 b(an)m(y)c(pre\014x)g(and)f (su\016x)h(sp)s(eci\014ed)f(with)i(the)f Ft(-P)g Fu(and)g -Ft(-S)f Fu(options)i(are)g(added)f(to)h(eac)m(h)150 4271 +Ft(-S)f Fu(options)i(are)g(added)f(to)h(eac)m(h)150 5230 y(mem)m(b)s(er)31 b(of)g(the)h(completion)h(list,)f(and)f(the)h(result) f(is)h(returned)e(to)i(the)g(Readline)g(completion)h(co)s(de)150 -4381 y(as)e(the)f(list)h(of)g(p)s(ossible)f(completions.)275 -4518 y(If)d(the)h(previously-applied)f(actions)i(do)f(not)g(generate)h -(an)m(y)f(matc)m(hes,)i(and)d(the)h Ft(-o)h(dirnames)d -Fu(op-)150 4628 y(tion)j(w)m(as)f(supplied)f(to)i Ft(complete)d -Fu(when)h(the)h(compsp)s(ec)g(w)m(as)g(de\014ned,)g(directory)g(name)h -(completion)150 4737 y(is)h(attempted.)275 4874 y(If)35 -b(the)g Ft(-o)30 b(plusdirs)j Fu(option)j(w)m(as)g(supplied)e(to)i -Ft(complete)e Fu(when)g(the)i(compsp)s(ec)f(w)m(as)h(de\014ned,)150 -4984 y(directory)g(name)f(completion)i(is)e(attempted)h(and)f(an)m(y)h +5340 y(as)e(the)f(list)h(of)g(p)s(ossible)f(completions.)p +eop end +%%Page: 139 145 +TeXDict begin 139 144 bop 150 -116 a Fu(Chapter)30 b(8:)41 +b(Command)29 b(Line)i(Editing)2062 b(139)275 299 y(If)27 +b(the)h(previously-applied)f(actions)i(do)f(not)g(generate)h(an)m(y)f +(matc)m(hes,)i(and)d(the)h Ft(-o)h(dirnames)d Fu(op-)150 +408 y(tion)j(w)m(as)f(supplied)f(to)i Ft(complete)d Fu(when)h(the)h +(compsp)s(ec)g(w)m(as)g(de\014ned,)g(directory)g(name)h(completion)150 +518 y(is)h(attempted.)275 653 y(If)35 b(the)g Ft(-o)30 +b(plusdirs)j Fu(option)j(w)m(as)g(supplied)e(to)i Ft(complete)e +Fu(when)g(the)i(compsp)s(ec)f(w)m(as)h(de\014ned,)150 +763 y(directory)g(name)f(completion)i(is)e(attempted)h(and)f(an)m(y)h (matc)m(hes)g(are)g(added)f(to)h(the)f(results)g(of)h(the)150 -5093 y(other)31 b(actions.)275 5230 y(By)g(default,)i(if)e(a)h(compsp)s +873 y(other)31 b(actions.)275 1008 y(By)g(default,)i(if)e(a)h(compsp)s (ec)f(is)h(found,)f(whatev)m(er)h(it)g(generates)h(is)e(returned)g(to)h -(the)g(completion)150 5340 y(co)s(de)21 b(as)g(the)g(full)g(set)g(of)g +(the)g(completion)150 1117 y(co)s(de)21 b(as)g(the)g(full)g(set)g(of)g (p)s(ossible)f(completions.)39 b(The)20 b(default)h(Bash)g(completions) -h(are)g(not)f(attempted,)p eop end -%%Page: 139 145 -TeXDict begin 139 144 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(139)150 299 y(and)30 -b(the)g(Readline)h(default)f(of)g(\014lename)h(completion)g(is)f -(disabled.)41 b(If)29 b(the)i Ft(-o)e(bashdefault)e Fu(option)150 -408 y(w)m(as)d(supplied)e(to)j Ft(complete)c Fu(when)i(the)g(compsp)s -(ec)h(w)m(as)g(de\014ned,)g(the)f(default)h(Bash)g(completions)h(are) -150 518 y(attempted)j(if)f(the)h(compsp)s(ec)f(generates)h(no)f(matc)m -(hes.)41 b(If)27 b(the)g Ft(-o)j(default)25 b Fu(option)j(w)m(as)f -(supplied)f(to)150 628 y Ft(complete)f Fu(when)h(the)h(compsp)s(ec)f(w) -m(as)i(de\014ned,)e(Readline's)i(default)f(completion)h(will)f(b)s(e)f -(p)s(erformed)150 737 y(if)k(the)h(compsp)s(ec)f(\(and,)g(if)h -(attempted,)g(the)g(default)f(Bash)h(completions\))h(generate)g(no)e -(matc)m(hes.)275 873 y(When)20 b(a)i(compsp)s(ec)e(indicates)i(that)g -(directory)g(name)f(completion)h(is)f(desired,)i(the)e(programmable)150 -982 y(completion)31 b(functions)e(force)i(Readline)f(to)h(app)s(end)d +h(are)g(not)f(attempted,)150 1227 y(and)30 b(the)g(Readline)h(default)f +(of)g(\014lename)h(completion)g(is)f(disabled.)41 b(If)29 +b(the)i Ft(-o)e(bashdefault)e Fu(option)150 1337 y(w)m(as)d(supplied)e +(to)j Ft(complete)c Fu(when)i(the)g(compsp)s(ec)h(w)m(as)g(de\014ned,)g +(the)f(default)h(Bash)g(completions)h(are)150 1446 y(attempted)j(if)f +(the)h(compsp)s(ec)f(generates)h(no)f(matc)m(hes.)41 +b(If)27 b(the)g Ft(-o)j(default)25 b Fu(option)j(w)m(as)f(supplied)f +(to)150 1556 y Ft(complete)f Fu(when)h(the)h(compsp)s(ec)f(w)m(as)i +(de\014ned,)e(Readline's)i(default)f(completion)h(will)f(b)s(e)f(p)s +(erformed)150 1665 y(if)k(the)h(compsp)s(ec)f(\(and,)g(if)h(attempted,) +g(the)g(default)f(Bash)h(completions\))h(generate)g(no)e(matc)m(hes.) +275 1801 y(When)20 b(a)i(compsp)s(ec)e(indicates)i(that)g(directory)g +(name)f(completion)h(is)f(desired,)i(the)e(programmable)150 +1910 y(completion)31 b(functions)e(force)i(Readline)f(to)h(app)s(end)d (a)i(slash)g(to)g(completed)h(names)e(whic)m(h)h(are)g(sym-)150 -1092 y(b)s(olic)40 b(links)g(to)h(directories,)j(sub)5 +2020 y(b)s(olic)40 b(links)g(to)h(directories,)j(sub)5 b(ject)40 b(to)h(the)f(v)-5 b(alue)41 b(of)f(the)g Fr(mark-directories) -45 b Fu(Readline)c(v)-5 b(ariable,)150 1201 y(regardless)31 +45 b Fu(Readline)c(v)-5 b(ariable,)150 2130 y(regardless)31 b(of)f(the)h(setting)g(of)g(the)f Fr(mark-symlink)m(ed-directories)36 -b Fu(Readline)31 b(v)-5 b(ariable.)275 1337 y(There)25 +b Fu(Readline)31 b(v)-5 b(ariable.)275 2265 y(There)25 b(is)i(some)g(supp)s(ort)e(for)h(dynamically)h(mo)s(difying)f (completions.)40 b(This)26 b(is)g(most)h(useful)f(when)150 -1446 y(used)40 b(in)h(com)m(bination)i(with)e(a)g(default)h(completion) +2374 y(used)40 b(in)h(com)m(bination)i(with)e(a)g(default)h(completion) g(sp)s(eci\014ed)f(with)g Ft(-D)p Fu(.)72 b(It's)42 b(p)s(ossible)f -(for)g(shell)150 1556 y(functions)28 b(executed)h(as)f(completion)i +(for)g(shell)150 2484 y(functions)28 b(executed)h(as)f(completion)i (handlers)d(to)i(indicate)g(that)g(completion)g(should)e(b)s(e)h -(retried)g(b)m(y)150 1666 y(returning)j(an)i(exit)g(status)f(of)h(124.) +(retried)g(b)m(y)150 2594 y(returning)j(an)i(exit)g(status)f(of)h(124.) 48 b(If)31 b(a)i(shell)f(function)g(returns)f(124,)k(and)c(c)m(hanges)j -(the)e(compsp)s(ec)150 1775 y(asso)s(ciated)43 b(with)e(the)g(command)g +(the)e(compsp)s(ec)150 2703 y(asso)s(ciated)43 b(with)e(the)g(command)g (on)g(whic)m(h)g(completion)i(is)e(b)s(eing)g(attempted)h(\(supplied)e -(as)i(the)150 1885 y(\014rst)29 b(argumen)m(t)h(when)e(the)i(function)f +(as)i(the)150 2813 y(\014rst)29 b(argumen)m(t)h(when)e(the)i(function)f (is)g(executed\),)j(programmable)d(completion)i(restarts)f(from)f(the) -150 1994 y(b)s(eginning,)e(with)g(an)h(attempt)g(to)g(\014nd)e(a)i(new) +150 2922 y(b)s(eginning,)e(with)g(an)h(attempt)g(to)g(\014nd)e(a)i(new) e(compsp)s(ec)i(for)f(that)h(command.)39 b(This)27 b(allo)m(ws)h(a)g -(set)g(of)150 2104 y(completions)33 b(to)f(b)s(e)g(built)f(dynamically) +(set)g(of)150 3032 y(completions)33 b(to)f(b)s(e)g(built)f(dynamically) i(as)f(completion)h(is)f(attempted,)h(rather)f(than)f(b)s(eing)g -(loaded)150 2214 y(all)g(at)g(once.)275 2349 y(F)-8 b(or)38 +(loaded)150 3142 y(all)g(at)g(once.)275 3277 y(F)-8 b(or)38 b(instance,)h(assuming)e(that)h(there)f(is)h(a)f(library)g(of)g(compsp) s(ecs,)i(eac)m(h)g(k)m(ept)e(in)g(a)h(\014le)f(corre-)150 -2459 y(sp)s(onding)g(to)j(the)f(name)f(of)h(the)g(command,)i(the)e +3386 y(sp)s(onding)g(to)j(the)f(name)f(of)h(the)g(command,)i(the)e (follo)m(wing)h(default)f(completion)h(function)e(w)m(ould)150 -2568 y(load)31 b(completions)g(dynamically:)390 2704 -y Ft(_completion_loader\(\))390 2813 y({)581 2923 y(.)47 +3496 y(load)31 b(completions)g(dynamically:)390 3631 +y Ft(_completion_loader\(\))390 3741 y({)581 3851 y(.)47 b("/etc/bash_completion.d/$1)o(.sh)o(")42 b(>/dev/null)j(2>&1)i(&&)g -(return)f(124)390 3032 y(})390 3142 y(complete)g(-D)h(-F)g +(return)f(124)390 3960 y(})390 4070 y(complete)g(-D)h(-F)g (_completion_loader)c(-o)k(bashdefault)e(-o)i(default)150 -3384 y Fs(8.7)68 b(Programmable)47 b(Completion)f(Builtins)150 -3543 y Fu(Three)21 b(builtin)g(commands)f(are)i(a)m(v)-5 +4312 y Fs(8.7)68 b(Programmable)47 b(Completion)f(Builtins)150 +4471 y Fu(Three)21 b(builtin)g(commands)f(are)i(a)m(v)-5 b(ailable)24 b(to)e(manipulate)f(the)h(programmable)f(completion)h -(facilities:)150 3653 y(one)34 b(to)g(sp)s(ecify)f(ho)m(w)h(the)f +(facilities:)150 4581 y(one)34 b(to)g(sp)s(ecify)f(ho)m(w)h(the)f (argumen)m(ts)h(to)g(a)g(particular)g(command)f(are)h(to)g(b)s(e)f -(completed,)j(and)d(t)m(w)m(o)150 3763 y(to)e(mo)s(dify)f(the)g -(completion)i(as)e(it)h(is)g(happ)s(ening.)150 3923 y -Ft(compgen)870 4058 y(compgen)46 b([)p Fj(option)p Ft(])f([)p -Fj(word)p Ft(])630 4193 y Fu(Generate)27 b(p)s(ossible)e(completion)i +(completed,)j(and)d(t)m(w)m(o)150 4690 y(to)e(mo)s(dify)f(the)g +(completion)i(as)e(it)h(is)g(happ)s(ening.)150 4851 y +Ft(compgen)870 4986 y(compgen)46 b([)p Fj(option)p Ft(])f([)p +Fj(word)p Ft(])630 5121 y Fu(Generate)27 b(p)s(ossible)e(completion)i (matc)m(hes)g(for)e Fr(w)m(ord)k Fu(according)e(to)f(the)g -Fr(option)p Fu(s,)h(whic)m(h)630 4303 y(ma)m(y)32 b(b)s(e)f(an)m(y)h +Fr(option)p Fu(s,)h(whic)m(h)630 5230 y(ma)m(y)32 b(b)s(e)f(an)m(y)h (option)g(accepted)g(b)m(y)g(the)f Ft(complete)f Fu(builtin)h(with)g -(the)g(exception)i(of)f Ft(-p)630 4413 y Fu(and)39 b +(the)g(exception)i(of)f Ft(-p)630 5340 y Fu(and)39 b Ft(-r)p Fu(,)i(and)e(write)h(the)g(matc)m(hes)g(to)g(the)g(standard)f -(output.)68 b(When)39 b(using)g(the)h Ft(-F)630 4522 -y Fu(or)33 b Ft(-C)f Fu(options,)i(the)e(v)-5 b(arious)33 -b(shell)g(v)-5 b(ariables)33 b(set)g(b)m(y)g(the)g(programmable)g -(completion)630 4632 y(facilities,)g(while)d(a)m(v)-5 -b(ailable,)33 b(will)e(not)g(ha)m(v)m(e)g(useful)f(v)-5 -b(alues.)630 4767 y(The)34 b(matc)m(hes)h(will)g(b)s(e)f(generated)h -(in)f(the)h(same)g(w)m(a)m(y)g(as)g(if)f(the)h(programmable)f(com-)630 -4876 y(pletion)d(co)s(de)g(had)f(generated)i(them)e(directly)i(from)e -(a)h(completion)h(sp)s(eci\014cation)f(with)630 4986 -y(the)e(same)h(\015ags.)40 b(If)29 b Fr(w)m(ord)j Fu(is)d(sp)s -(eci\014ed,)g(only)g(those)h(completions)g(matc)m(hing)g -Fr(w)m(ord)j Fu(will)630 5095 y(b)s(e)d(displa)m(y)m(ed.)630 -5230 y(The)24 b(return)g(v)-5 b(alue)25 b(is)g(true)f(unless)g(an)h(in) -m(v)-5 b(alid)25 b(option)g(is)g(supplied,)f(or)h(no)g(matc)m(hes)g(w)m -(ere)630 5340 y(generated.)p eop end +(output.)68 b(When)39 b(using)g(the)h Ft(-F)p eop end %%Page: 140 146 TeXDict begin 140 145 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(140)150 299 y Ft(complete)870 -432 y(complete)46 b([-abcdefgjksuv])d([-o)k Fj(comp-option)p -Ft(])e([-DEI])h([-A)h Fj(action)p Ft(])e([-)870 542 y(G)i -Fj(globpat)p Ft(])870 651 y([-W)g Fj(wordlist)p Ft(])e([-F)i -Fj(function)p Ft(])e([-C)i Fj(command)p Ft(])f([-X)h -Fj(filterpat)p Ft(])870 761 y([-P)g Fj(prefix)p Ft(])f([-S)h -Fj(suffix)p Ft(])e Fj(name)i Ft([)p Fj(name)f Ft(...])870 -870 y(complete)g(-pr)g([-DEI])h([)p Fj(name)f Ft(...)o(])630 -1003 y Fu(Sp)s(ecify)37 b(ho)m(w)h(argumen)m(ts)f(to)i(eac)m(h)g -Fr(name)j Fu(should)37 b(b)s(e)g(completed.)63 b(If)38 -b(the)f Ft(-p)g Fu(option)630 1113 y(is)30 b(supplied,)e(or)i(if)g(no)f -(options)h(are)g(supplied,)f(existing)h(completion)h(sp)s -(eci\014cations)g(are)630 1223 y(prin)m(ted)24 b(in)h(a)g(w)m(a)m(y)g +b(Command)29 b(Line)i(Editing)2062 b(140)630 299 y(or)33 +b Ft(-C)f Fu(options,)i(the)e(v)-5 b(arious)33 b(shell)g(v)-5 +b(ariables)33 b(set)g(b)m(y)g(the)g(programmable)g(completion)630 +408 y(facilities,)g(while)d(a)m(v)-5 b(ailable,)33 b(will)e(not)g(ha)m +(v)m(e)g(useful)f(v)-5 b(alues.)630 555 y(The)34 b(matc)m(hes)h(will)g +(b)s(e)f(generated)h(in)f(the)h(same)g(w)m(a)m(y)g(as)g(if)f(the)h +(programmable)f(com-)630 664 y(pletion)d(co)s(de)g(had)f(generated)i +(them)e(directly)i(from)e(a)h(completion)h(sp)s(eci\014cation)f(with) +630 774 y(the)e(same)h(\015ags.)40 b(If)29 b Fr(w)m(ord)j +Fu(is)d(sp)s(eci\014ed,)g(only)g(those)h(completions)g(matc)m(hing)g +Fr(w)m(ord)j Fu(will)630 883 y(b)s(e)d(displa)m(y)m(ed.)630 +1029 y(The)24 b(return)g(v)-5 b(alue)25 b(is)g(true)f(unless)g(an)h(in) +m(v)-5 b(alid)25 b(option)g(is)g(supplied,)f(or)h(no)g(matc)m(hes)g(w)m +(ere)630 1139 y(generated.)150 1322 y Ft(complete)870 +1468 y(complete)46 b([-abcdefgjksuv])d([-o)k Fj(comp-option)p +Ft(])e([-DEI])h([-A)h Fj(action)p Ft(])e([-)870 1577 +y(G)i Fj(globpat)p Ft(])870 1687 y([-W)g Fj(wordlist)p +Ft(])e([-F)i Fj(function)p Ft(])e([-C)i Fj(command)p +Ft(])f([-X)h Fj(filterpat)p Ft(])870 1797 y([-P)g Fj(prefix)p +Ft(])f([-S)h Fj(suffix)p Ft(])e Fj(name)i Ft([)p Fj(name)f +Ft(...])870 1906 y(complete)g(-pr)g([-DEI])h([)p Fj(name)f +Ft(...)o(])630 2052 y Fu(Sp)s(ecify)37 b(ho)m(w)h(argumen)m(ts)f(to)i +(eac)m(h)g Fr(name)j Fu(should)37 b(b)s(e)g(completed.)63 +b(If)38 b(the)f Ft(-p)g Fu(option)630 2162 y(is)30 b(supplied,)e(or)i +(if)g(no)f(options)h(are)g(supplied,)f(existing)h(completion)h(sp)s +(eci\014cations)g(are)630 2271 y(prin)m(ted)24 b(in)h(a)g(w)m(a)m(y)g (that)h(allo)m(ws)g(them)e(to)i(b)s(e)e(reused)f(as)i(input.)38 -b(The)24 b Ft(-r)g Fu(option)i(remo)m(v)m(es)630 1332 +b(The)24 b Ft(-r)g Fu(option)i(remo)m(v)m(es)630 2381 y(a)i(completion)h(sp)s(eci\014cation)f(for)g(eac)m(h)h Fr(name)p Fu(,)f(or,)h(if)e(no)h Fr(name)5 b Fu(s)27 -b(are)h(supplied,)g(all)g(com-)630 1442 y(pletion)i(sp)s +b(are)h(supplied,)g(all)g(com-)630 2491 y(pletion)i(sp)s (eci\014cations.)42 b(The)29 b Ft(-D)g Fu(option)h(indicates)h(that)f -(other)g(supplied)e(options)j(and)630 1551 y(actions)c(should)e(apply)g +(other)g(supplied)e(options)j(and)630 2600 y(actions)c(should)e(apply)g (to)i(the)f(\\default")h(command)e(completion;)k(that)e(is,)g -(completion)630 1661 y(attempted)g(on)f(a)h(command)f(for)g(whic)m(h)g +(completion)630 2710 y(attempted)g(on)f(a)h(command)f(for)g(whic)m(h)g (no)g(completion)i(has)d(previously)h(b)s(een)g(de\014ned.)630 -1771 y(The)e Ft(-E)g Fu(option)h(indicates)g(that)g(other)g(supplied)e -(options)h(and)g(actions)i(should)d(apply)h(to)630 1880 +2819 y(The)e Ft(-E)g Fu(option)h(indicates)g(that)g(other)g(supplied)e +(options)h(and)g(actions)i(should)d(apply)h(to)630 2929 y(\\empt)m(y")33 b(command)e(completion;)i(that)f(is,)g(completion)h -(attempted)f(on)g(a)f(blank)g(line.)630 1990 y(The)24 +(attempted)f(on)g(a)f(blank)g(line.)630 3039 y(The)24 b Ft(-I)g Fu(option)h(indicates)g(that)g(other)g(supplied)e(options)h -(and)g(actions)i(should)d(apply)h(to)630 2099 y(completion)29 +(and)g(actions)i(should)d(apply)h(to)630 3148 y(completion)29 b(on)g(the)f(initial)h(non-assignmen)m(t)g(w)m(ord)f(on)g(the)g(line,)i -(or)e(after)h(a)f(command)630 2209 y(delimiter)41 b(suc)m(h)g(as)f(`)p +(or)e(after)h(a)f(command)630 3258 y(delimiter)41 b(suc)m(h)g(as)f(`)p Ft(;)p Fu(')h(or)g(`)p Ft(|)p Fu(',)i(whic)m(h)e(is)f(usually)h -(command)f(name)h(completion.)72 b(If)630 2318 y(m)m(ultiple)26 +(command)f(name)h(completion.)72 b(If)630 3367 y(m)m(ultiple)26 b(options)g(are)g(supplied,)g(the)f Ft(-D)g Fu(option)h(tak)m(es)i (precedence)e(o)m(v)m(er)g Ft(-E)p Fu(,)h(and)e(b)s(oth)630 -2428 y(tak)m(e)34 b(precedence)f(o)m(v)m(er)h Ft(-I)p +3477 y(tak)m(e)34 b(precedence)f(o)m(v)m(er)h Ft(-I)p Fu(.)47 b(If)32 b(an)m(y)h(of)g Ft(-D)p Fu(,)g Ft(-E)p Fu(,)f(or)h Ft(-I)f Fu(are)h(supplied,)f(an)m(y)h(other)g -Fr(name)630 2538 y Fu(argumen)m(ts)k(are)g(ignored;)j(these)d +Fr(name)630 3587 y Fu(argumen)m(ts)k(are)g(ignored;)j(these)d (completions)h(only)e(apply)g(to)i(the)f(case)g(sp)s(eci\014ed)f(b)m(y) -630 2647 y(the)31 b(option.)630 2780 y(The)e(pro)s(cess)g(of)h +630 3696 y(the)31 b(option.)630 3842 y(The)e(pro)s(cess)g(of)h (applying)g(these)g(completion)g(sp)s(eci\014cations)h(when)d(w)m(ord)i -(completion)630 2890 y(is)35 b(attempted)h(is)f(describ)s(ed)f(ab)s(o)m +(completion)630 3952 y(is)35 b(attempted)h(is)f(describ)s(ed)f(ab)s(o)m (v)m(e)j(\(see)f(Section)g(8.6)g([Programmable)g(Completion],)630 -2999 y(page)31 b(137\).)630 3133 y(Other)d(options,)i(if)f(sp)s +4061 y(page)31 b(137\).)630 4208 y(Other)d(options,)i(if)f(sp)s (eci\014ed,)g(ha)m(v)m(e)h(the)f(follo)m(wing)i(meanings.)40 -b(The)29 b(argumen)m(ts)g(to)h(the)630 3242 y Ft(-G)p +b(The)29 b(argumen)m(ts)g(to)h(the)630 4317 y Ft(-G)p Fu(,)41 b Ft(-W)p Fu(,)h(and)c Ft(-X)h Fu(options)h(\(and,)h(if)f (necessary)-8 b(,)42 b(the)e Ft(-P)f Fu(and)f Ft(-S)h -Fu(options\))h(should)f(b)s(e)630 3352 y(quoted)28 b(to)h(protect)g +Fu(options\))h(should)f(b)s(e)630 4427 y(quoted)28 b(to)h(protect)g (them)f(from)f(expansion)h(b)s(efore)g(the)g Ft(complete)e -Fu(builtin)h(is)h(in)m(v)m(ok)m(ed.)630 3508 y Ft(-o)i -Fj(comp-option)1110 3618 y Fu(The)c Fr(comp-option)i +Fu(builtin)h(is)h(in)m(v)m(ok)m(ed.)630 4609 y Ft(-o)i +Fj(comp-option)1110 4719 y Fu(The)c Fr(comp-option)i Fu(con)m(trols)g(sev)m(eral)h(asp)s(ects)e(of)g(the)g(compsp)s(ec's)g -(b)s(eha)m(v-)1110 3727 y(ior)g(b)s(ey)m(ond)f(the)g(simple)h +(b)s(eha)m(v-)1110 4829 y(ior)g(b)s(ey)m(ond)f(the)g(simple)h (generation)h(of)e(completions.)41 b Fr(comp-option)27 -b Fu(ma)m(y)1110 3837 y(b)s(e)j(one)g(of:)1110 3994 y -Ft(bashdefault)1590 4103 y Fu(P)m(erform)d(the)h(rest)f(of)h(the)g -(default)f(Bash)h(completions)g(if)g(the)1590 4213 y(compsp)s(ec)i -(generates)i(no)e(matc)m(hes.)1110 4369 y Ft(default)144 -b Fu(Use)22 b(Readline's)g(default)g(\014lename)g(completion)g(if)g -(the)g(comp-)1590 4479 y(sp)s(ec)30 b(generates)i(no)e(matc)m(hes.)1110 -4635 y Ft(dirnames)96 b Fu(P)m(erform)46 b(directory)g(name)h -(completion)g(if)f(the)g(compsp)s(ec)1590 4745 y(generates)32 -b(no)e(matc)m(hes.)1110 4902 y Ft(filenames)1590 5011 -y Fu(T)-8 b(ell)40 b(Readline)f(that)h(the)f(compsp)s(ec)f(generates)j -(\014lenames,)1590 5121 y(so)29 b(it)h(can)f(p)s(erform)f(an)m(y)h -(\014lename-sp)s(eci\014c)h(pro)s(cessing)e(\(lik)m(e)1590 -5230 y(adding)22 b(a)g(slash)g(to)h(directory)f(names,)i(quoting)f(sp)s -(ecial)f(c)m(har-)1590 5340 y(acters,)39 b(or)d(suppressing)f(trailing) -i(spaces\).)59 b(This)35 b(option)i(is)p eop end +b Fu(ma)m(y)1110 4938 y(b)s(e)j(one)g(of:)1110 5121 y +Ft(bashdefault)1590 5230 y Fu(P)m(erform)d(the)h(rest)f(of)h(the)g +(default)f(Bash)h(completions)g(if)g(the)1590 5340 y(compsp)s(ec)i +(generates)i(no)e(matc)m(hes.)p eop end %%Page: 141 147 TeXDict begin 141 146 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(141)1590 299 y(in)m(tended)30 +b(Command)29 b(Line)i(Editing)2062 b(141)1110 299 y Ft(default)144 +b Fu(Use)22 b(Readline's)g(default)g(\014lename)g(completion)g(if)g +(the)g(comp-)1590 408 y(sp)s(ec)30 b(generates)i(no)e(matc)m(hes.)1110 +570 y Ft(dirnames)96 b Fu(P)m(erform)46 b(directory)g(name)h +(completion)g(if)f(the)g(compsp)s(ec)1590 680 y(generates)32 +b(no)e(matc)m(hes.)1110 841 y Ft(filenames)1590 951 y +Fu(T)-8 b(ell)40 b(Readline)f(that)h(the)f(compsp)s(ec)f(generates)j +(\014lenames,)1590 1060 y(so)29 b(it)h(can)f(p)s(erform)f(an)m(y)h +(\014lename-sp)s(eci\014c)h(pro)s(cessing)e(\(lik)m(e)1590 +1170 y(adding)22 b(a)g(slash)g(to)h(directory)f(names,)i(quoting)f(sp)s +(ecial)f(c)m(har-)1590 1279 y(acters,)39 b(or)d(suppressing)f(trailing) +i(spaces\).)59 b(This)35 b(option)i(is)1590 1389 y(in)m(tended)30 b(to)g(b)s(e)g(used)f(with)g(shell)i(functions)e(sp)s(eci\014ed)g(with) -1590 408 y Ft(-F)p Fu(.)1110 565 y Ft(noquote)144 b Fu(T)-8 -b(ell)28 b(Readline)g(not)g(to)g(quote)g(the)g(completed)g(w)m(ords)f -(if)h(they)1590 675 y(are)j(\014lenames)f(\(quoting)h(\014lenames)g(is) -f(the)h(default\).)1110 831 y Ft(nosort)192 b Fu(T)-8 -b(ell)23 b(Readline)g(not)f(to)h(sort)g(the)f(list)h(of)f(p)s(ossible)g -(completions)1590 941 y(alphab)s(etically)-8 b(.)1110 -1097 y Ft(nospace)144 b Fu(T)-8 b(ell)40 b(Readline)g(not)g(to)g(app)s -(end)d(a)j(space)g(\(the)f(default\))h(to)1590 1207 y(w)m(ords)30 -b(completed)h(at)g(the)g(end)f(of)g(the)h(line.)1110 -1363 y Ft(plusdirs)96 b Fu(After)30 b(an)m(y)h(matc)m(hes)g(de\014ned)d -(b)m(y)i(the)g(compsp)s(ec)g(are)g(gener-)1590 1473 y(ated,)g +1590 1499 y Ft(-F)p Fu(.)1110 1660 y Ft(noquote)144 b +Fu(T)-8 b(ell)28 b(Readline)g(not)g(to)g(quote)g(the)g(completed)g(w)m +(ords)f(if)h(they)1590 1770 y(are)j(\014lenames)f(\(quoting)h +(\014lenames)g(is)f(the)h(default\).)1110 1931 y Ft(nosort)192 +b Fu(T)-8 b(ell)23 b(Readline)g(not)f(to)h(sort)g(the)f(list)h(of)f(p)s +(ossible)g(completions)1590 2041 y(alphab)s(etically)-8 +b(.)1110 2202 y Ft(nospace)144 b Fu(T)-8 b(ell)40 b(Readline)g(not)g +(to)g(app)s(end)d(a)j(space)g(\(the)f(default\))h(to)1590 +2312 y(w)m(ords)30 b(completed)h(at)g(the)g(end)f(of)g(the)h(line.)1110 +2473 y Ft(plusdirs)96 b Fu(After)30 b(an)m(y)h(matc)m(hes)g(de\014ned)d +(b)m(y)i(the)g(compsp)s(ec)g(are)g(gener-)1590 2583 y(ated,)g (directory)f(name)g(completion)i(is)d(attempted)i(and)f(an)m(y)1590 -1583 y(matc)m(hes)j(are)e(added)g(to)h(the)g(results)f(of)g(the)h -(other)g(actions.)630 1739 y Ft(-A)f Fj(action)66 b Fu(The)25 +2693 y(matc)m(hes)j(are)e(added)g(to)h(the)g(results)f(of)g(the)h +(other)g(actions.)630 2854 y Ft(-A)f Fj(action)66 b Fu(The)25 b Fr(action)h Fu(ma)m(y)g(b)s(e)e(one)h(of)h(the)f(follo)m(wing)i(to)e -(generate)i(a)e(list)h(of)f(p)s(ossible)1110 1849 y(completions:)1110 -2005 y Ft(alias)240 b Fu(Alias)31 b(names.)41 b(Ma)m(y)31 +(generate)i(a)e(list)h(of)f(p)s(ossible)1110 2964 y(completions:)1110 +3125 y Ft(alias)240 b Fu(Alias)31 b(names.)41 b(Ma)m(y)31 b(also)h(b)s(e)e(sp)s(eci\014ed)f(as)i Ft(-a)p Fu(.)1110 -2162 y Ft(arrayvar)96 b Fu(Arra)m(y)31 b(v)-5 b(ariable)31 -b(names.)1110 2318 y Ft(binding)144 b Fu(Readline)30 +3287 y Ft(arrayvar)96 b Fu(Arra)m(y)31 b(v)-5 b(ariable)31 +b(names.)1110 3448 y Ft(binding)144 b Fu(Readline)30 b(k)m(ey)f(binding)f(names)h(\(see)h(Section)f(8.4)h([Bindable)1590 -2428 y(Readline)h(Commands],)f(page)h(127\).)1110 2585 +3558 y(Readline)h(Commands],)f(page)h(127\).)1110 3719 y Ft(builtin)144 b Fu(Names)21 b(of)g(shell)f(builtin)h(commands.)37 -b(Ma)m(y)21 b(also)h(b)s(e)e(sp)s(eci\014ed)1590 2694 -y(as)31 b Ft(-b)p Fu(.)1110 2851 y Ft(command)144 b Fu(Command)29 +b(Ma)m(y)21 b(also)h(b)s(e)e(sp)s(eci\014ed)1590 3829 +y(as)31 b Ft(-b)p Fu(.)1110 3990 y Ft(command)144 b Fu(Command)29 b(names.)41 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i -Ft(-c)p Fu(.)1110 3007 y Ft(directory)1590 3117 y Fu(Directory)h +Ft(-c)p Fu(.)1110 4152 y Ft(directory)1590 4261 y Fu(Directory)h (names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)g(as)g -Ft(-d)p Fu(.)1110 3273 y Ft(disabled)96 b Fu(Names)31 -b(of)g(disabled)f(shell)g(builtins.)1110 3430 y Ft(enabled)144 +Ft(-d)p Fu(.)1110 4423 y Ft(disabled)96 b Fu(Names)31 +b(of)g(disabled)f(shell)g(builtins.)1110 4584 y Ft(enabled)144 b Fu(Names)31 b(of)g(enabled)f(shell)g(builtins.)1110 -3587 y Ft(export)192 b Fu(Names)34 b(of)f(exp)s(orted)f(shell)h(v)-5 +4746 y Ft(export)192 b Fu(Names)34 b(of)f(exp)s(orted)f(shell)h(v)-5 b(ariables.)49 b(Ma)m(y)35 b(also)e(b)s(e)g(sp)s(eci-)1590 -3696 y(\014ed)d(as)g Ft(-e)p Fu(.)1110 3853 y Ft(file)288 +4855 y(\014ed)d(as)g Ft(-e)p Fu(.)1110 5017 y Ft(file)288 b Fu(File)32 b(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f -(as)i Ft(-f)p Fu(.)1110 4009 y Ft(function)96 b Fu(Names)31 -b(of)g(shell)f(functions.)1110 4166 y Ft(group)240 b +(as)i Ft(-f)p Fu(.)1110 5178 y Ft(function)96 b Fu(Names)31 +b(of)g(shell)f(functions.)1110 5340 y Ft(group)240 b Fu(Group)30 b(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)g -(as)g Ft(-g)p Fu(.)1110 4322 y Ft(helptopic)1590 4432 -y Fu(Help)37 b(topics)g(as)g(accepted)h(b)m(y)e(the)h -Ft(help)f Fu(builtin)g(\(see)h(Sec-)1590 4542 y(tion)31 -b(4.2)g([Bash)g(Builtins],)g(page)g(51\).)1110 4698 y +(as)g Ft(-g)p Fu(.)p eop end +%%Page: 142 148 +TeXDict begin 142 147 bop 150 -116 a Fu(Chapter)30 b(8:)41 +b(Command)29 b(Line)i(Editing)2062 b(142)1110 299 y Ft(helptopic)1590 +408 y Fu(Help)37 b(topics)g(as)g(accepted)h(b)m(y)e(the)h +Ft(help)f Fu(builtin)g(\(see)h(Sec-)1590 518 y(tion)31 +b(4.2)g([Bash)g(Builtins],)g(page)g(51\).)1110 689 y Ft(hostname)96 b Fu(Hostnames,)89 b(as)76 b(tak)m(en)h(from)f(the)g -(\014le)h(sp)s(eci\014ed)e(b)m(y)1590 4808 y(the)55 b +(\014le)h(sp)s(eci\014ed)e(b)m(y)1590 799 y(the)55 b Ft(HOSTFILE)e Fu(shell)j(v)-5 b(ariable)56 b(\(see)g(Section)g(5.2)h -([Bash)1590 4917 y(V)-8 b(ariables],)32 b(page)f(73\).)1110 -5074 y Ft(job)336 b Fu(Job)31 b(names,)h(if)g(job)f(con)m(trol)i(is)f +([Bash)1590 908 y(V)-8 b(ariables],)32 b(page)f(73\).)1110 +1080 y Ft(job)336 b Fu(Job)31 b(names,)h(if)g(job)f(con)m(trol)i(is)f (activ)m(e.)46 b(Ma)m(y)33 b(also)g(b)s(e)e(sp)s(eci-)1590 -5183 y(\014ed)f(as)g Ft(-j)p Fu(.)1110 5340 y Ft(keyword)144 +1189 y(\014ed)f(as)g Ft(-j)p Fu(.)1110 1361 y Ft(keyword)144 b Fu(Shell)30 b(reserv)m(ed)h(w)m(ords.)40 b(Ma)m(y)32 -b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i Ft(-k)p Fu(.)p -eop end -%%Page: 142 148 -TeXDict begin 142 147 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(142)1110 299 y Ft(running)144 -b Fu(Names)31 b(of)g(running)d(jobs,)i(if)h(job)f(con)m(trol)h(is)g -(activ)m(e.)1110 463 y Ft(service)144 b Fu(Service)31 -b(names.)41 b(Ma)m(y)31 b(also)g(b)s(e)f(sp)s(eci\014ed)g(as)g -Ft(-s)p Fu(.)1110 628 y Ft(setopt)192 b Fu(V)-8 b(alid)39 -b(argumen)m(ts)g(for)f(the)h Ft(-o)e Fu(option)i(to)g(the)g -Ft(set)e Fu(builtin)1590 737 y(\(see)31 b(Section)h(4.3.1)g([The)e(Set) -g(Builtin],)i(page)f(62\).)1110 902 y Ft(shopt)240 b -Fu(Shell)40 b(option)g(names)g(as)g(accepted)i(b)m(y)e(the)g -Ft(shopt)e Fu(builtin)1590 1011 y(\(see)31 b(Section)h(4.2)f([Bash)g -(Builtins],)g(page)g(51\).)1110 1176 y Ft(signal)192 -b Fu(Signal)31 b(names.)1110 1340 y Ft(stopped)144 b -Fu(Names)31 b(of)g(stopp)s(ed)e(jobs,)h(if)g(job)g(con)m(trol)i(is)f -(activ)m(e.)1110 1504 y Ft(user)288 b Fu(User)30 b(names.)41 -b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i Ft(-u)p -Fu(.)1110 1669 y Ft(variable)96 b Fu(Names)36 b(of)g(all)g(shell)g(v)-5 -b(ariables.)56 b(Ma)m(y)37 b(also)f(b)s(e)f(sp)s(eci\014ed)g(as)1590 -1778 y Ft(-v)p Fu(.)630 1943 y Ft(-C)30 b Fj(command)1110 -2052 y Fr(command)35 b Fu(is)e(executed)g(in)e(a)i(subshell)e(en)m -(vironmen)m(t,)i(and)f(its)g(output)g(is)1110 2162 y(used)e(as)g(the)h -(p)s(ossible)f(completions.)630 2326 y Ft(-F)g Fj(function)1110 -2436 y Fu(The)39 b(shell)g(function)g Fr(function)g Fu(is)g(executed)h -(in)f(the)g(curren)m(t)g(shell)g(en)m(vi-)1110 2545 y(ronmen)m(t.)72 +b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i Ft(-k)p Fu(.)1110 +1532 y Ft(running)144 b Fu(Names)31 b(of)g(running)d(jobs,)i(if)h(job)f +(con)m(trol)h(is)g(activ)m(e.)1110 1703 y Ft(service)144 +b Fu(Service)31 b(names.)41 b(Ma)m(y)31 b(also)g(b)s(e)f(sp)s +(eci\014ed)g(as)g Ft(-s)p Fu(.)1110 1874 y Ft(setopt)192 +b Fu(V)-8 b(alid)39 b(argumen)m(ts)g(for)f(the)h Ft(-o)e +Fu(option)i(to)g(the)g Ft(set)e Fu(builtin)1590 1984 +y(\(see)31 b(Section)h(4.3.1)g([The)e(Set)g(Builtin],)i(page)f(62\).) +1110 2155 y Ft(shopt)240 b Fu(Shell)40 b(option)g(names)g(as)g +(accepted)i(b)m(y)e(the)g Ft(shopt)e Fu(builtin)1590 +2265 y(\(see)31 b(Section)h(4.2)f([Bash)g(Builtins],)g(page)g(51\).) +1110 2436 y Ft(signal)192 b Fu(Signal)31 b(names.)1110 +2607 y Ft(stopped)144 b Fu(Names)31 b(of)g(stopp)s(ed)e(jobs,)h(if)g +(job)g(con)m(trol)i(is)f(activ)m(e.)1110 2778 y Ft(user)288 +b Fu(User)30 b(names.)41 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f +(as)i Ft(-u)p Fu(.)1110 2950 y Ft(variable)96 b Fu(Names)36 +b(of)g(all)g(shell)g(v)-5 b(ariables.)56 b(Ma)m(y)37 +b(also)f(b)s(e)f(sp)s(eci\014ed)g(as)1590 3059 y Ft(-v)p +Fu(.)630 3230 y Ft(-C)30 b Fj(command)1110 3340 y Fr(command)35 +b Fu(is)e(executed)g(in)e(a)i(subshell)e(en)m(vironmen)m(t,)i(and)f +(its)g(output)g(is)1110 3450 y(used)e(as)g(the)h(p)s(ossible)f +(completions.)630 3621 y Ft(-F)g Fj(function)1110 3730 +y Fu(The)39 b(shell)g(function)g Fr(function)g Fu(is)g(executed)h(in)f +(the)g(curren)m(t)g(shell)g(en)m(vi-)1110 3840 y(ronmen)m(t.)72 b(When)41 b(it)g(is)g(executed,)k($1)c(is)g(the)g(name)g(of)g(the)g -(command)1110 2655 y(whose)34 b(argumen)m(ts)h(are)g(b)s(eing)f +(command)1110 3950 y(whose)34 b(argumen)m(ts)h(are)g(b)s(eing)f (completed,)j($2)e(is)f(the)h(w)m(ord)f(b)s(eing)g(com-)1110 -2765 y(pleted,)44 b(and)c($3)i(is)e(the)h(w)m(ord)g(preceding)f(the)h -(w)m(ord)f(b)s(eing)h(completed,)1110 2874 y(as)g(describ)s(ed)f(ab)s +4059 y(pleted,)44 b(and)c($3)i(is)e(the)h(w)m(ord)g(preceding)f(the)h +(w)m(ord)f(b)s(eing)h(completed,)1110 4169 y(as)g(describ)s(ed)f(ab)s (o)m(v)m(e)i(\(see)g(Section)f(8.6)h([Programmable)g(Completion],)1110 -2984 y(page)30 b(137\).)42 b(When)29 b(it)h(\014nishes,)e(the)h(p)s -(ossible)g(completions)h(are)g(retriev)m(ed)1110 3093 +4278 y(page)30 b(137\).)42 b(When)29 b(it)h(\014nishes,)e(the)h(p)s +(ossible)g(completions)h(are)g(retriev)m(ed)1110 4388 y(from)g(the)g(v)-5 b(alue)31 b(of)g(the)f Ft(COMPREPLY)e -Fu(arra)m(y)j(v)-5 b(ariable.)630 3258 y Ft(-G)30 b Fj(globpat)1110 -3367 y Fu(The)39 b(\014lename)h(expansion)g(pattern)g -Fr(globpat)j Fu(is)d(expanded)f(to)h(generate)1110 3477 -y(the)31 b(p)s(ossible)e(completions.)630 3641 y Ft(-P)h +Fu(arra)m(y)j(v)-5 b(ariable.)630 4559 y Ft(-G)30 b Fj(globpat)1110 +4669 y Fu(The)39 b(\014lename)h(expansion)g(pattern)g +Fr(globpat)j Fu(is)d(expanded)f(to)h(generate)1110 4778 +y(the)31 b(p)s(ossible)e(completions.)630 4950 y Ft(-P)h Fj(prefix)66 b Fr(pre\014x)39 b Fu(is)34 b(added)f(at)i(the)f(b)s (eginning)f(of)i(eac)m(h)g(p)s(ossible)e(completion)i(after)1110 -3751 y(all)c(other)g(options)g(ha)m(v)m(e)g(b)s(een)f(applied.)630 -3915 y Ft(-S)g Fj(suffix)66 b Fr(su\016x)26 b Fu(is)20 +5059 y(all)c(other)g(options)g(ha)m(v)m(e)g(b)s(een)f(applied.)630 +5230 y Ft(-S)g Fj(suffix)66 b Fr(su\016x)26 b Fu(is)20 b(app)s(ended)f(to)i(eac)m(h)h(p)s(ossible)e(completion)i(after)f(all)g -(other)g(options)1110 4025 y(ha)m(v)m(e)32 b(b)s(een)d(applied.)630 -4189 y Ft(-W)h Fj(wordlist)1110 4299 y Fu(The)24 b Fr(w)m(ordlist)k +(other)g(options)1110 5340 y(ha)m(v)m(e)32 b(b)s(een)d(applied.)p +eop end +%%Page: 143 149 +TeXDict begin 143 148 bop 150 -116 a Fu(Chapter)30 b(8:)41 +b(Command)29 b(Line)i(Editing)2062 b(143)630 299 y Ft(-W)30 +b Fj(wordlist)1110 408 y Fu(The)24 b Fr(w)m(ordlist)k Fu(is)d(split)g(using)f(the)h(c)m(haracters)i(in)d(the)i -Ft(IFS)e Fu(sp)s(ecial)h(v)-5 b(ariable)1110 4408 y(as)36 +Ft(IFS)e Fu(sp)s(ecial)h(v)-5 b(ariable)1110 518 y(as)36 b(delimiters,)i(and)e(eac)m(h)h(resultan)m(t)g(w)m(ord)e(is)h -(expanded.)57 b(The)35 b(p)s(ossible)1110 4518 y(completions)c(are)e +(expanded.)57 b(The)35 b(p)s(ossible)1110 628 y(completions)c(are)e (the)h(mem)m(b)s(ers)f(of)g(the)h(resultan)m(t)g(list)g(whic)m(h)f -(matc)m(h)i(the)1110 4628 y(w)m(ord)f(b)s(eing)g(completed.)630 -4792 y Ft(-X)g Fj(filterpat)1110 4902 y Fr(\014lterpat)d +(matc)m(h)i(the)1110 737 y(w)m(ord)f(b)s(eing)g(completed.)630 +909 y Ft(-X)g Fj(filterpat)1110 1019 y Fr(\014lterpat)d Fu(is)e(a)g(pattern)g(as)f(used)g(for)h(\014lename)g(expansion.)38 -b(It)25 b(is)g(applied)f(to)1110 5011 y(the)30 b(list)f(of)h(p)s +b(It)25 b(is)g(applied)f(to)1110 1128 y(the)30 b(list)f(of)h(p)s (ossible)f(completions)h(generated)h(b)m(y)e(the)g(preceding)h(options) -1110 5121 y(and)d(argumen)m(ts,)i(and)e(eac)m(h)i(completion)g(matc)m -(hing)g Fr(\014lterpat)h Fu(is)e(remo)m(v)m(ed)1110 5230 +1110 1238 y(and)d(argumen)m(ts,)i(and)e(eac)m(h)i(completion)g(matc)m +(hing)g Fr(\014lterpat)h Fu(is)e(remo)m(v)m(ed)1110 1347 y(from)i(the)h(list.)42 b(A)30 b(leading)i(`)p Ft(!)p Fu(')e(in)g Fr(\014lterpat)j Fu(negates)f(the)f(pattern;)g(in)f(this) -1110 5340 y(case,)i(an)m(y)e(completion)i(not)f(matc)m(hing)g -Fr(\014lterpat)i Fu(is)d(remo)m(v)m(ed.)p eop end -%%Page: 143 149 -TeXDict begin 143 148 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(143)630 299 y(The)35 +1110 1457 y(case,)i(an)m(y)e(completion)i(not)f(matc)m(hing)g +Fr(\014lterpat)i Fu(is)d(remo)m(v)m(ed.)630 1629 y(The)35 b(return)g(v)-5 b(alue)37 b(is)f(true)f(unless)h(an)f(in)m(v)-5 b(alid)37 b(option)f(is)g(supplied,)g(an)g(option)h(other)630 -408 y(than)h Ft(-p)g Fu(or)g Ft(-r)f Fu(is)h(supplied)f(without)i(a)f +1738 y(than)h Ft(-p)g Fu(or)g Ft(-r)f Fu(is)h(supplied)f(without)i(a)f Fr(name)44 b Fu(argumen)m(t,)c(an)e(attempt)i(is)e(made)g(to)630 -518 y(remo)m(v)m(e)32 b(a)e(completion)i(sp)s(eci\014cation)f(for)f(a)h -Fr(name)k Fu(for)30 b(whic)m(h)g(no)g(sp)s(eci\014cation)h(exists,)630 -628 y(or)f(an)h(error)f(o)s(ccurs)g(adding)g(a)g(completion)i(sp)s -(eci\014cation.)150 788 y Ft(compopt)870 923 y(compopt)46 +1848 y(remo)m(v)m(e)32 b(a)e(completion)i(sp)s(eci\014cation)f(for)f(a) +h Fr(name)k Fu(for)30 b(whic)m(h)g(no)g(sp)s(eci\014cation)h(exists,) +630 1958 y(or)f(an)h(error)f(o)s(ccurs)g(adding)g(a)g(completion)i(sp)s +(eci\014cation.)150 2129 y Ft(compopt)870 2270 y(compopt)46 b([-o)h Fj(option)p Ft(])f([-DEI])g([+o)h Fj(option)p -Ft(])e([)p Fj(name)p Ft(])630 1058 y Fu(Mo)s(dify)33 +Ft(])e([)p Fj(name)p Ft(])630 2411 y Fu(Mo)s(dify)33 b(completion)h(options)g(for)f(eac)m(h)h Fr(name)39 b Fu(according)34 b(to)g(the)f Fr(option)p Fu(s,)i(or)e(for)g(the)630 -1168 y(curren)m(tly-executing)46 b(completion)f(if)f(no)f +2520 y(curren)m(tly-executing)46 b(completion)f(if)f(no)f Fr(name)5 b Fu(s)44 b(are)h(supplied.)80 b(If)43 b(no)h -Fr(option)p Fu(s)h(are)630 1277 y(giv)m(en,)30 b(displa)m(y)e(the)g +Fr(option)p Fu(s)h(are)630 2630 y(giv)m(en,)30 b(displa)m(y)e(the)g (completion)h(options)g(for)e(eac)m(h)i Fr(name)34 b -Fu(or)27 b(the)i(curren)m(t)e(completion.)630 1387 y(The)f(p)s(ossible) +Fu(or)27 b(the)i(curren)m(t)e(completion.)630 2740 y(The)f(p)s(ossible) g(v)-5 b(alues)27 b(of)f Fr(option)h Fu(are)g(those)g(v)-5 b(alid)26 b(for)g(the)h Ft(complete)d Fu(builtin)i(describ)s(ed)630 -1496 y(ab)s(o)m(v)m(e.)41 b(The)27 b Ft(-D)f Fu(option)i(indicates)g +2849 y(ab)s(o)m(v)m(e.)41 b(The)27 b Ft(-D)f Fu(option)i(indicates)g (that)g(other)f(supplied)f(options)i(should)e(apply)h(to)h(the)630 -1606 y(\\default")33 b(command)f(completion;)i(that)f(is,)g(completion) -g(attempted)g(on)f(a)g(command)630 1716 y(for)g(whic)m(h)g(no)g +2959 y(\\default")33 b(command)f(completion;)i(that)f(is,)g(completion) +g(attempted)g(on)f(a)g(command)630 3068 y(for)g(whic)m(h)g(no)g (completion)i(has)e(previously)g(b)s(een)g(de\014ned.)45 -b(The)32 b Ft(-E)f Fu(option)i(indicates)630 1825 y(that)23 +b(The)32 b Ft(-E)f Fu(option)i(indicates)630 3178 y(that)23 b(other)f(supplied)e(options)j(should)e(apply)g(to)i(\\empt)m(y")g -(command)f(completion;)k(that)630 1935 y(is,)36 b(completion)g +(command)f(completion;)k(that)630 3287 y(is,)36 b(completion)g (attempted)g(on)e(a)h(blank)g(line.)54 b(The)34 b Ft(-I)g -Fu(option)h(indicates)g(that)h(other)630 2044 y(supplied)23 +Fu(option)h(indicates)g(that)h(other)630 3397 y(supplied)23 b(options)i(should)f(apply)g(to)i(completion)g(on)e(the)h(initial)h -(non-assignmen)m(t)f(w)m(ord)630 2154 y(on)37 b(the)f(line,)j(or)e +(non-assignmen)m(t)f(w)m(ord)630 3507 y(on)37 b(the)f(line,)j(or)e (after)g(a)g(command)f(delimiter)i(suc)m(h)e(as)h(`)p Ft(;)p Fu(')g(or)f(`)p Ft(|)p Fu(',)j(whic)m(h)e(is)f(usually)630 -2263 y(command)30 b(name)h(completion.)630 2398 y(If)k(m)m(ultiple)i +3616 y(command)30 b(name)h(completion.)630 3757 y(If)k(m)m(ultiple)i (options)f(are)g(supplied,)g(the)g Ft(-D)g Fu(option)g(tak)m(es)h -(precedence)g(o)m(v)m(er)g Ft(-E)p Fu(,)g(and)630 2508 +(precedence)g(o)m(v)m(er)g Ft(-E)p Fu(,)g(and)630 3867 y(b)s(oth)30 b(tak)m(e)i(precedence)e(o)m(v)m(er)i Ft(-I)630 -2643 y Fu(The)23 b(return)g(v)-5 b(alue)25 b(is)f(true)g(unless)f(an)h +4007 y Fu(The)23 b(return)g(v)-5 b(alue)25 b(is)f(true)g(unless)f(an)h (in)m(v)-5 b(alid)24 b(option)h(is)f(supplied,)g(an)g(attempt)h(is)f -(made)630 2753 y(to)32 b(mo)s(dify)f(the)g(options)h(for)f(a)h +(made)630 4117 y(to)32 b(mo)s(dify)f(the)g(options)h(for)f(a)h Fr(name)k Fu(for)31 b(whic)m(h)g(no)g(completion)i(sp)s(eci\014cation)f -(exists,)630 2862 y(or)e(an)h(output)f(error)g(o)s(ccurs.)150 -3104 y Fs(8.8)68 b(A)44 b(Programmable)j(Completion)f(Example)150 -3264 y Fu(The)37 b(most)g(common)g(w)m(a)m(y)i(to)e(obtain)h +(exists,)630 4226 y(or)e(an)h(output)f(error)g(o)s(ccurs.)150 +4486 y Fs(8.8)68 b(A)44 b(Programmable)j(Completion)f(Example)150 +4645 y Fu(The)37 b(most)g(common)g(w)m(a)m(y)i(to)e(obtain)h (additional)g(completion)g(functionalit)m(y)h(b)s(ey)m(ond)d(the)i -(default)150 3373 y(actions)29 b Ft(complete)d Fu(and)i +(default)150 4755 y(actions)29 b Ft(complete)d Fu(and)i Ft(compgen)e Fu(pro)m(vide)i(is)h(to)f(use)g(a)h(shell)f(function)g -(and)g(bind)e(it)j(to)g(a)g(particular)150 3483 y(command)h(using)g -Ft(complete)e(-F)p Fu(.)275 3618 y(The)j(follo)m(wing)j(function)e(pro) +(and)g(bind)e(it)j(to)g(a)g(particular)150 4864 y(command)h(using)g +Ft(complete)e(-F)p Fu(.)275 5011 y(The)j(follo)m(wing)j(function)e(pro) m(vides)g(completions)i(for)e(the)g Ft(cd)g Fu(builtin.)46 -b(It)32 b(is)h(a)f(reasonably)h(go)s(o)s(d)150 3728 y(example)41 +b(It)32 b(is)h(a)f(reasonably)h(go)s(o)s(d)150 5121 y(example)41 b(of)g(what)f(shell)h(functions)f(m)m(ust)g(do)h(when)e(used)h(for)g -(completion.)73 b(This)39 b(function)h(uses)150 3838 +(completion.)73 b(This)39 b(function)h(uses)150 5230 y(the)32 b(w)m(ord)f(passed)g(as)h Ft($2)f Fu(to)h(determine)g(the)f (directory)h(name)g(to)g(complete.)46 b(Y)-8 b(ou)32 -b(can)g(also)g(use)g(the)150 3947 y Ft(COMP_WORDS)c Fu(arra)m(y)i(v)-5 +b(can)g(also)g(use)g(the)150 5340 y Ft(COMP_WORDS)c Fu(arra)m(y)i(v)-5 b(ariable;)32 b(the)e(curren)m(t)h(w)m(ord)f(is)g(indexed)g(b)m(y)g -(the)h Ft(COMP_CWORD)c Fu(v)-5 b(ariable.)275 4083 y(The)42 +(the)h Ft(COMP_CWORD)c Fu(v)-5 b(ariable.)p eop end +%%Page: 144 150 +TeXDict begin 144 149 bop 150 -116 a Fu(Chapter)30 b(8:)41 +b(Command)29 b(Line)i(Editing)2062 b(144)275 299 y(The)42 b(function)h(relies)h(on)e(the)i Ft(complete)c Fu(and)j Ft(compgen)e Fu(builtins)h(to)i(do)f(m)m(uc)m(h)g(of)g(the)h(w)m(ork,) -150 4192 y(adding)25 b(only)h(the)g(things)g(that)g(the)g(Bash)g +150 408 y(adding)25 b(only)h(the)g(things)g(that)g(the)g(Bash)g Ft(cd)f Fu(do)s(es)g(b)s(ey)m(ond)g(accepting)j(basic)e(directory)g -(names:)38 b(tilde)150 4302 y(expansion)22 b(\(see)h(Section)g(3.5.2)g +(names:)38 b(tilde)150 518 y(expansion)22 b(\(see)h(Section)g(3.5.2)g ([Tilde)g(Expansion],)g(page)g(24\),)i(searc)m(hing)e(directories)g(in) -e Fr($CDP)-8 b(A)g(TH)p Fu(,)150 4411 y(whic)m(h)21 b(is)h(describ)s -(ed)e(ab)s(o)m(v)m(e)j(\(see)f(Section)h(4.1)f([Bourne)g(Shell)f +e Fr($CDP)-8 b(A)g(TH)p Fu(,)150 628 y(whic)m(h)21 b(is)h(describ)s(ed) +e(ab)s(o)m(v)m(e)j(\(see)f(Section)h(4.1)f([Bourne)g(Shell)f (Builtins],)j(page)e(44\),)j(and)c(basic)h(supp)s(ort)150 -4521 y(for)31 b(the)h Ft(cdable_vars)d Fu(shell)i(option)h(\(see)h +737 y(for)31 b(the)h Ft(cdable_vars)d Fu(shell)i(option)h(\(see)h (Section)f(4.3.2)i([The)d(Shopt)g(Builtin],)i(page)f(66\).)46 -b Ft(_comp_)150 4631 y(cd)30 b Fu(mo)s(di\014es)g(the)h(v)-5 +b Ft(_comp_)150 847 y(cd)30 b Fu(mo)s(di\014es)g(the)h(v)-5 b(alue)31 b(of)g Fr(IFS)36 b Fu(so)31 b(that)g(it)g(con)m(tains)h(only) f(a)g(newline)g(to)h(accommo)s(date)g(\014le)f(names)150 -4740 y(con)m(taining)i(spaces)g(and)e(tabs)h({)g Ft(compgen)e +956 y(con)m(taining)i(spaces)g(and)e(tabs)h({)g Ft(compgen)e Fu(prin)m(ts)h(the)h(p)s(ossible)f(completions)i(it)g(generates)g(one)f -(p)s(er)150 4850 y(line.)275 4985 y(P)m(ossible)24 b(completions)h(go)g +(p)s(er)150 1066 y(line.)275 1230 y(P)m(ossible)24 b(completions)h(go)g (in)m(to)g(the)f Fr(COMPREPL)-8 b(Y)36 b Fu(arra)m(y)24 b(v)-5 b(ariable,)26 b(one)e(completion)i(p)s(er)c(arra)m(y)150 -5095 y(elemen)m(t.)42 b(The)30 b(programmable)g(completion)i(system)e +1340 y(elemen)m(t.)42 b(The)30 b(programmable)g(completion)i(system)e (retriev)m(es)h(the)g(completions)g(from)f(there)g(when)150 -5205 y(the)h(function)f(returns.)390 5340 y Ft(#)47 b(A)h(completion)d -(function)g(for)i(the)g(cd)g(builtin)p eop end -%%Page: 144 150 -TeXDict begin 144 149 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(144)390 299 y Ft(#)47 -b(based)g(on)g(the)g(cd)g(completion)e(function)h(from)g(the)h -(bash_completion)d(package)390 408 y(_comp_cd\(\))390 -518 y({)581 628 y(local)i(IFS=$')g(\\t\\n')190 b(#)47 -b(normalize)f(IFS)581 737 y(local)g(cur)h(_skipdot)f(_cdpath)581 -847 y(local)g(i)i(j)f(k)581 1066 y(#)g(Tilde)g(expansion,)e(which)h -(also)h(expands)f(tilde)g(to)h(full)g(pathname)581 1176 -y(case)g("$2")f(in)581 1285 y(\\~*\))190 b(eval)46 b(cur="$2")g(;;)581 -1395 y(*\))286 b(cur=$2)46 b(;;)581 1504 y(esac)581 1724 -y(#)h(no)h(cdpath)e(or)h(absolute)e(pathname)h(--)h(straight)f -(directory)f(completion)581 1833 y(if)i([[)g(-z)g("${CDPATH:-}")e(]])i -(||)g([[)g("$cur")f(==)h(@\(./*|../*|/*\))d(]];)j(then)772 -1943 y(#)g(compgen)f(prints)g(paths)h(one)f(per)h(line;)g(could)f(also) -h(use)g(while)f(loop)772 2052 y(IFS=$'\\n')772 2162 y(COMPREPLY=\()f -($\(compgen)g(-d)i(--)g("$cur"\))f(\))772 2271 y(IFS=$')g(\\t\\n')581 -2381 y(#)h(CDPATH+directories)c(in)k(the)g(current)f(directory)f(if)j -(not)e(in)i(CDPATH)581 2491 y(else)772 2600 y(IFS=$'\\n')772 -2710 y(_skipdot=false)772 2819 y(#)f(preprocess)e(CDPATH)h(to)i -(convert)d(null)i(directory)e(names)i(to)g(.)772 2929 -y(_cdpath=${CDPATH/#:/.:})772 3039 y(_cdpath=${_cdpath//::/:.)o(:})772 -3148 y(_cdpath=${_cdpath/\045:/:.})772 3258 y(for)g(i)g(in)g -(${_cdpath//:/$'\\n'};)c(do)963 3367 y(if)k([[)g($i)g(-ef)g(.)h(]];)f -(then)f(_skipdot=true;)e(fi)963 3477 y(k="${#COMPREPLY[@]}")963 -3587 y(for)j(j)g(in)g($\()g(compgen)f(-d)h(--)h("$i/$cur")d(\);)i(do) -1154 3696 y(COMPREPLY[k++]=${j#$i/})375 b(#)48 b(cut)f(off)f(directory) -963 3806 y(done)772 3915 y(done)772 4025 y($_skipdot)f(||)i -(COMPREPLY+=\()e($\(compgen)g(-d)i(--)g("$cur"\))f(\))772 -4134 y(IFS=$')g(\\t\\n')581 4244 y(fi)581 4463 y(#)h(variable)f(names)g -(if)h(appropriate)e(shell)i(option)f(set)h(and)f(no)i(completions)581 -4573 y(if)f(shopt)f(-q)i(cdable_vars)c(&&)k([[)f(${#COMPREPLY[@]})c -(-eq)k(0)g(]];)g(then)772 4682 y(COMPREPLY=\()e($\(compgen)g(-v)i(--)g -("$cur"\))f(\))581 4792 y(fi)581 5011 y(return)g(0)390 -5121 y(})275 5340 y Fu(W)-8 b(e)31 b(install)g(the)g(completion)h -(function)e(using)f(the)i Ft(-F)f Fu(option)h(to)g Ft(complete)p -Fu(:)p eop end +1450 y(the)h(function)f(returns.)390 1614 y Ft(#)47 b(A)h(completion)d +(function)g(for)i(the)g(cd)g(builtin)390 1724 y(#)g(based)g(on)g(the)g +(cd)g(completion)e(function)h(from)g(the)h(bash_completion)d(package) +390 1833 y(_comp_cd\(\))390 1943 y({)581 2052 y(local)i(IFS=$')g +(\\t\\n')190 b(#)47 b(normalize)f(IFS)581 2162 y(local)g(cur)h +(_skipdot)f(_cdpath)581 2271 y(local)g(i)i(j)f(k)581 +2491 y(#)g(Tilde)g(expansion,)e(which)h(also)h(expands)f(tilde)g(to)h +(full)g(pathname)581 2600 y(case)g("$2")f(in)581 2710 +y(\\~*\))190 b(eval)46 b(cur="$2")g(;;)581 2819 y(*\))286 +b(cur=$2)46 b(;;)581 2929 y(esac)581 3148 y(#)h(no)h(cdpath)e(or)h +(absolute)e(pathname)h(--)h(straight)f(directory)f(completion)581 +3258 y(if)i([[)g(-z)g("${CDPATH:-}")e(]])i(||)g([[)g("$cur")f(==)h +(@\(./*|../*|/*\))d(]];)j(then)772 3367 y(#)g(compgen)f(prints)g(paths) +h(one)f(per)h(line;)g(could)f(also)h(use)g(while)f(loop)772 +3477 y(IFS=$'\\n')772 3587 y(COMPREPLY=\()f($\(compgen)g(-d)i(--)g +("$cur"\))f(\))772 3696 y(IFS=$')g(\\t\\n')581 3806 y(#)h +(CDPATH+directories)c(in)k(the)g(current)f(directory)f(if)j(not)e(in)i +(CDPATH)581 3915 y(else)772 4025 y(IFS=$'\\n')772 4134 +y(_skipdot=false)772 4244 y(#)f(preprocess)e(CDPATH)h(to)i(convert)d +(null)i(directory)e(names)i(to)g(.)772 4354 y(_cdpath=${CDPATH/#:/.:}) +772 4463 y(_cdpath=${_cdpath//::/:.)o(:})772 4573 y +(_cdpath=${_cdpath/\045:/:.})772 4682 y(for)g(i)g(in)g +(${_cdpath//:/$'\\n'};)c(do)963 4792 y(if)k([[)g($i)g(-ef)g(.)h(]];)f +(then)f(_skipdot=true;)e(fi)963 4902 y(k="${#COMPREPLY[@]}")963 +5011 y(for)j(j)g(in)g($\()g(compgen)f(-d)h(--)h("$i/$cur")d(\);)i(do) +1154 5121 y(COMPREPLY[k++]=${j#$i/})375 b(#)48 b(cut)f(off)f(directory) +963 5230 y(done)772 5340 y(done)p eop end %%Page: 145 151 TeXDict begin 145 150 bop 150 -116 a Fu(Chapter)30 b(8:)41 -b(Command)29 b(Line)i(Editing)2062 b(145)390 299 y Ft(#)47 -b(Tell)g(readline)f(to)h(quote)f(appropriate)f(and)i(append)f(slashes)g -(to)h(directories;)390 408 y(#)g(use)g(the)g(bash)g(default)f -(completion)f(for)i(other)f(arguments)390 518 y(complete)g(-o)h -(filenames)e(-o)i(nospace)f(-o)h(bashdefault)e(-F)i(_comp_cd)f(cd)150 -653 y Fu(Since)33 b(w)m(e'd)g(lik)m(e)i(Bash)e(and)f(Readline)i(to)g -(tak)m(e)g(care)g(of)f(some)h(of)f(the)g(other)h(details)g(for)e(us,)i -(w)m(e)f(use)150 762 y(sev)m(eral)43 b(other)g(options)f(to)h(tell)g -(Bash)f(and)f(Readline)i(what)f(to)g(do.)76 b(The)41 -b Ft(-o)30 b(filenames)39 b Fu(option)150 872 y(tells)j(Readline)g -(that)g(the)f(p)s(ossible)g(completions)h(should)f(b)s(e)f(treated)i -(as)g(\014lenames,)i(and)d(quoted)150 981 y(appropriately)-8 -b(.)53 b(That)34 b(option)h(will)g(also)g(cause)g(Readline)g(to)g(app)s -(end)e(a)h(slash)g(to)h(\014lenames)g(it)g(can)150 1091 -y(determine)i(are)g(directories)h(\(whic)m(h)g(is)f(wh)m(y)f(w)m(e)i -(migh)m(t)f(w)m(an)m(t)h(to)g(extend)f Ft(_comp_cd)e -Fu(to)i(app)s(end)f(a)150 1200 y(slash)22 b(if)g(w)m(e're)h(using)f -(directories)h(found)e(via)i Fr(CDP)-8 b(A)g(TH)10 b -Fu(:)37 b(Readline)23 b(can't)g(tell)g(those)g(completions)h(are)150 -1310 y(directories\).)45 b(The)31 b Ft(-o)f(nospace)f -Fu(option)j(tells)g(Readline)g(to)h(not)e(app)s(end)f(a)i(space)g(c)m -(haracter)h(to)f(the)150 1420 y(directory)c(name,)h(in)f(case)h(w)m(e)f -(w)m(an)m(t)h(to)f(app)s(end)f(to)h(it.)41 b(The)27 b -Ft(-o)j(bashdefault)25 b Fu(option)j(brings)f(in)h(the)150 -1529 y(rest)h(of)f(the)h Ft(")p Fu(Bash)f(default)p Ft(")h +b(Command)29 b(Line)i(Editing)2062 b(145)772 299 y Ft($_skipdot)45 +b(||)i(COMPREPLY+=\()e($\(compgen)g(-d)i(--)g("$cur"\))f(\))772 +408 y(IFS=$')g(\\t\\n')581 518 y(fi)581 737 y(#)h(variable)f(names)g +(if)h(appropriate)e(shell)i(option)f(set)h(and)f(no)i(completions)581 +847 y(if)f(shopt)f(-q)i(cdable_vars)c(&&)k([[)f(${#COMPREPLY[@]})c(-eq) +k(0)g(]];)g(then)772 956 y(COMPREPLY=\()e($\(compgen)g(-v)i(--)g +("$cur"\))f(\))581 1066 y(fi)581 1285 y(return)g(0)390 +1395 y(})275 1529 y Fu(W)-8 b(e)31 b(install)g(the)g(completion)h +(function)e(using)f(the)i Ft(-F)f Fu(option)h(to)g Ft(complete)p +Fu(:)390 1664 y Ft(#)47 b(Tell)g(readline)f(to)h(quote)f(appropriate)f +(and)i(append)f(slashes)g(to)h(directories;)390 1773 +y(#)g(use)g(the)g(bash)g(default)f(completion)f(for)i(other)f +(arguments)390 1883 y(complete)g(-o)h(filenames)e(-o)i(nospace)f(-o)h +(bashdefault)e(-F)i(_comp_cd)f(cd)150 2017 y Fu(Since)33 +b(w)m(e'd)g(lik)m(e)i(Bash)e(and)f(Readline)i(to)g(tak)m(e)g(care)g(of) +f(some)h(of)f(the)g(other)h(details)g(for)e(us,)i(w)m(e)f(use)150 +2127 y(sev)m(eral)43 b(other)g(options)f(to)h(tell)g(Bash)f(and)f +(Readline)i(what)f(to)g(do.)76 b(The)41 b Ft(-o)30 b(filenames)39 +b Fu(option)150 2237 y(tells)j(Readline)g(that)g(the)f(p)s(ossible)g +(completions)h(should)f(b)s(e)f(treated)i(as)g(\014lenames,)i(and)d +(quoted)150 2346 y(appropriately)-8 b(.)53 b(That)34 +b(option)h(will)g(also)g(cause)g(Readline)g(to)g(app)s(end)e(a)h(slash) +g(to)h(\014lenames)g(it)g(can)150 2456 y(determine)i(are)g(directories) +h(\(whic)m(h)g(is)f(wh)m(y)f(w)m(e)i(migh)m(t)f(w)m(an)m(t)h(to)g +(extend)f Ft(_comp_cd)e Fu(to)i(app)s(end)f(a)150 2565 +y(slash)22 b(if)g(w)m(e're)h(using)f(directories)h(found)e(via)i +Fr(CDP)-8 b(A)g(TH)10 b Fu(:)37 b(Readline)23 b(can't)g(tell)g(those)g +(completions)h(are)150 2675 y(directories\).)45 b(The)31 +b Ft(-o)f(nospace)f Fu(option)j(tells)g(Readline)g(to)h(not)e(app)s +(end)f(a)i(space)g(c)m(haracter)h(to)f(the)150 2785 y(directory)c +(name,)h(in)f(case)h(w)m(e)f(w)m(an)m(t)h(to)f(app)s(end)f(to)h(it.)41 +b(The)27 b Ft(-o)j(bashdefault)25 b Fu(option)j(brings)f(in)h(the)150 +2894 y(rest)h(of)f(the)h Ft(")p Fu(Bash)f(default)p Ft(")h Fu(completions)g({)g(p)s(ossible)f(completion)i(that)f(Bash)f(adds)g -(to)h(the)g(default)150 1639 y(Readline)f(set.)40 b(These)28 +(to)h(the)g(default)150 3004 y(Readline)f(set.)40 b(These)28 b(include)f(things)g(lik)m(e)i(command)e(name)h(completion,)h(v)-5 -b(ariable)28 b(completion)h(for)150 1748 y(w)m(ords)e(b)s(eginning)h +b(ariable)28 b(completion)h(for)150 3113 y(w)m(ords)e(b)s(eginning)h (with)f(`)p Ft($)p Fu(')h(or)g(`)p Ft(${)p Fu(',)h(completions)g(con)m (taining)g(pathname)f(expansion)g(patterns)g(\(see)150 -1858 y(Section)j(3.5.8)h([Filename)g(Expansion],)e(page)i(33\),)f(and)f -(so)h(on.)275 1993 y(Once)39 b(installed)i(using)e Ft(complete)p +3223 y(Section)j(3.5.8)h([Filename)g(Expansion],)e(page)i(33\),)f(and)f +(so)h(on.)275 3357 y(Once)39 b(installed)i(using)e Ft(complete)p Fu(,)h Ft(_comp_cd)d Fu(will)j(b)s(e)g(called)g(ev)m(ery)h(time)f(w)m -(e)g(attempt)h(w)m(ord)150 2102 y(completion)32 b(for)e(a)h -Ft(cd)e Fu(command.)275 2237 y(Man)m(y)34 b(more)g(examples)g({)g(an)g +(e)g(attempt)h(w)m(ord)150 3467 y(completion)32 b(for)e(a)h +Ft(cd)e Fu(command.)275 3601 y(Man)m(y)34 b(more)g(examples)g({)g(an)g (extensiv)m(e)h(collection)i(of)c(completions)i(for)f(most)g(of)g(the)g -(common)150 2346 y(GNU,)g(Unix,)h(and)d(Lin)m(ux)h(commands)g({)h(are)g +(common)150 3711 y(GNU,)g(Unix,)h(and)d(Lin)m(ux)h(commands)g({)h(are)g (a)m(v)-5 b(ailable)36 b(as)e(part)f(of)h(the)f(bash)p -2943 2346 28 4 v 39 w(completion)i(pro)5 b(ject.)150 -2456 y(This)33 b(is)h(installed)h(b)m(y)f(default)g(on)g(man)m(y)h +2943 3711 28 4 v 39 w(completion)i(pro)5 b(ject.)150 +3821 y(This)33 b(is)h(installed)h(b)m(y)f(default)g(on)g(man)m(y)h (GNU/Lin)m(ux)f(distributions.)51 b(Originally)35 b(written)f(b)m(y)g -(Ian)150 2565 y(Macdonald,)48 b(the)c(pro)5 b(ject)44 +(Ian)150 3930 y(Macdonald,)48 b(the)c(pro)5 b(ject)44 b(no)m(w)g(liv)m(es)h(at)f Ft(https:)11 b(/)g(/)g(github)g(.)g(com)g(/) g(sc)o(op)g(/)f(bash)o(-co)o(mple)o(tion)g(/)h Fu(.)150 -2675 y(There)30 b(are)h(p)s(orts)e(for)h(other)h(systems)f(suc)m(h)g -(as)h(Solaris)g(and)f(Mac)h(OS)f(X.)275 2809 y(An)54 -b(older)h(v)m(ersion)h(of)f(the)g(bash)p 1532 2809 V +4040 y(There)30 b(are)h(p)s(orts)e(for)h(other)h(systems)f(suc)m(h)g +(as)h(Solaris)g(and)f(Mac)h(OS)f(X.)275 4174 y(An)54 +b(older)h(v)m(ersion)h(of)f(the)g(bash)p 1532 4174 V 40 w(completion)h(pac)m(k)-5 b(age)57 b(is)e(distributed)f(with)h(bash) -f(in)h(the)150 2919 y Ft(examples/complete)26 b Fu(sub)s(directory)-8 +f(in)h(the)150 4284 y Ft(examples/complete)26 b Fu(sub)s(directory)-8 b(.)p eop end %%Page: 146 152 TeXDict begin 146 151 bop 3614 -116 a Fu(146)150 299 @@ -21224,33 +21260,34 @@ g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)32 b Fb(82)150 758 y Fe(PPID)11 b Fc(:)j(:)f(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)h(:)25 b Fb(82)150 846 y Fe(PROMPT_COMMANDS)17 b Fc(:)g(:)c(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 b Fb(82)150 933 y -Fe(PROMPT_DIRTRIM)23 b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)34 b Fb(83)150 1020 y Fe(PS0)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)28 b Fb(83)150 1107 y Fe(PS1)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)28 b Fb(73)150 1194 y Fe(PS2)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)28 b Fb(73)150 1281 y Fe(PS3)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)28 b Fb(83)150 1369 y Fe(PS4)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)28 b Fb(83)150 1456 y Fe(PWD)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)28 b Fb(83)146 1689 y Fs(R)150 1804 y Fe(RANDOM)6 -b Fc(:)15 b(:)e(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) -g(:)g(:)g(:)g(:)g(:)h(:)f(:)20 b Fb(83)150 1892 y Fe(READLINE_LINE)25 +(:)h(:)25 b Fb(82)150 846 y Fe(PROMPT_COMMAND)e Fc(:)13 +b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 +b Fb(82)150 933 y Fe(PROMPT_DIRTRIM)23 b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) +g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 b Fb(83)150 1020 y Fe(PS0)14 +b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) +h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)28 b Fb(83)150 +1107 y Fe(PS1)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) +g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)28 +b Fb(73)150 1194 y Fe(PS2)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)28 +b Fb(73)150 1281 y Fe(PS3)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)28 +b Fb(83)150 1369 y Fe(PS4)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)28 +b Fb(83)150 1456 y Fe(PWD)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)28 +b Fb(83)146 1689 y Fs(R)150 1804 y Fe(RANDOM)6 b Fc(:)15 +b(:)e(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) +g(:)g(:)g(:)h(:)f(:)20 b Fb(83)150 1892 y Fe(READLINE_LINE)25 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 b Fb(83)150 1979 y Fe(READLINE_MARK)25 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g @@ -21318,11 +21355,11 @@ f(:)g(:)35 b Fb(120)150 3751 y Fs(D.4)68 b(F)-11 b(unction)44 b(Index)146 4237 y(A)150 4354 y Fe(abort)27 b(\(C-g\))15 b Fc(:)f(:)f(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)30 -b Fb(134)150 4442 y Fe(accept-line)e(\(Newline)g(or)e(Return\))12 +b Fb(135)150 4442 y Fe(accept-line)e(\(Newline)g(or)e(Return\))12 b Fc(:)i(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)27 b Fb(128)150 4529 y Fe(alias-expand-line)i(\(\))9 b Fc(:)14 b(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(136)146 4784 y Fs(B)150 +(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(137)146 4784 y Fs(B)150 4902 y Fe(backward-char)29 b(\(C-b\))12 b Fc(:)i(:)f(:)g(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)26 b Fb(127)150 4989 y Fe(backward-delete-char)k(\(Rubout\))22 @@ -21357,7 +21394,7 @@ b Fc(:)h(:)e(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)29 b Fb(128)2025 5250 y Fe(complete)e(\(TAB\))7 b Fc(:)15 b(:)e(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)22 b Fb(132)2025 5340 y Fe(complete-command)29 +g(:)g(:)g(:)h(:)f(:)22 b Fb(133)2025 5340 y Fe(complete-command)29 b(\(M-!\))22 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)36 b Fb(134)p eop end %%Page: 180 186 @@ -21366,14 +21403,14 @@ b(D:)i(Indexes)2623 b(180)150 264 y Fe(complete-filename)29 b(\(M-/\))20 b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(133)150 353 y Fe(complete-hostname) c(\(M-@\))20 b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(133)150 442 y Fe +g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(134)150 442 y Fe (complete-into-braces)d(\(M-{\))11 b Fc(:)j(:)f(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)26 b Fb(134)150 531 y Fe(complete-username)j(\(M-~\))20 b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(133)150 621 y Fe(complete-variable)c(\(M-$\))20 b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)g(:)h(:)f(:)33 b Fb(133)150 710 y Fe(copy-backward-word)d(\(\))7 +(:)g(:)h(:)f(:)33 b Fb(134)150 710 y Fe(copy-backward-word)d(\(\))7 b Fc(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)21 b Fb(132)150 799 y Fe(copy-forward-word) 29 b(\(\))9 b Fc(:)14 b(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g @@ -21399,7 +21436,7 @@ Fb(136)150 1825 y Fe(do-lowercase-version)30 b(\(M-A,)227 (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)25 b Fb(135)150 2001 y Fe(downcase-word)k(\(M-l\)) 12 b Fc(:)i(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h -(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(130)150 2090 +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(131)150 2090 y Fe(dump-functions)j(\(\))17 b Fc(:)c(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) 32 b Fb(136)150 2180 y Fe(dump-macros)c(\(\))7 b Fc(:)14 @@ -21440,7 +21477,7 @@ Fc(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g b(\(C-x)d(g\))13 b Fc(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)27 b Fb(136)2021 294 y Fs(H)2025 422 y Fe (history-and-alias-expand-line)32 b(\(\))13 b Fc(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)g(:)28 b Fb(136)2025 513 y Fe(history-expand-line)i +g(:)g(:)g(:)g(:)28 b Fb(137)2025 513 y Fe(history-expand-line)i (\(M-^\))13 b Fc(:)h(:)g(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) g(:)g(:)g(:)h(:)28 b Fb(136)2025 604 y Fe(history-search-backward)j (\(\))11 b Fc(:)i(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g @@ -21452,11 +21489,11 @@ y Fe(history-substring-search-forwa)q(rd)d(\(\))22 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)37 b Fb(129)2021 1200 y Fs(I)2025 1329 y Fe(insert-comment)29 b(\(M-#\))9 b Fc(:)14 b(:)f(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -24 b Fb(135)2025 1420 y Fe(insert-completions)29 b(\(M-*\))16 +24 b Fb(136)2025 1420 y Fe(insert-completions)29 b(\(M-*\))16 b Fc(:)f(:)e(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)31 b Fb(133)2025 1507 y Fe(insert-last-argument)f(\(M-.)c(or)g (M-_\))7 b Fc(:)14 b(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)22 -b Fb(136)2021 1834 y Fs(K)2025 1962 y Fe(kill-line)27 +b Fb(137)2021 1834 y Fs(K)2025 1962 y Fe(kill-line)27 b(\(C-k\))c Fc(:)14 b(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)37 b Fb(131)2025 2053 y Fe(kill-region)28 b(\(\))7 b Fc(:)14 @@ -21470,7 +21507,7 @@ f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)29 b Fb(131)2025 g(:)g(:)g(:)37 b Fb(131)2021 2548 y Fs(M)2025 2676 y Fe(magic-space)28 b(\(\))7 b Fc(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)h(:)f(:)22 b Fb(136)2025 2767 y Fe(menu-complete)28 +g(:)g(:)h(:)f(:)22 b Fb(137)2025 2767 y Fe(menu-complete)28 b(\(\))20 b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)34 b Fb(133)2025 2854 y Fe(menu-complete-backward)c(\(\))13 @@ -21483,7 +21520,7 @@ h(:)28 b Fb(133)2021 3181 y Fs(N)2025 3309 y Fe(next-history)g(\(C-n\)) 27 b Fb(128)2025 3472 y Fe(non-incremental-forward-)2102 3560 y(search-history)h(\(M-n\))23 b Fc(:)14 b(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)37 -b Fb(128)2025 3647 y Fe(non-incremental-reverse-)2102 +b Fb(129)2025 3647 y Fe(non-incremental-reverse-)2102 3734 y(search-history)28 b(\(M-p\))23 b Fc(:)14 b(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)37 b Fb(128)2021 4070 y Fs(O)2025 4198 y Fe(operate-and-get-next)30 @@ -21506,7 +21543,7 @@ b Fc(:)13 b(:)g(:)g(:)g(:)22 b Fb(134)150 762 y Fe (possible-username-completions)32 b(\(C-x)27 b(~\))7 b Fc(:)13 b(:)g(:)g(:)g(:)22 b Fb(133)150 849 y Fe (possible-variable-completions)32 b(\(C-x)27 b($\))7 -b Fc(:)13 b(:)g(:)g(:)g(:)22 b Fb(133)150 937 y Fe(prefix-meta)28 +b Fc(:)13 b(:)g(:)g(:)g(:)22 b Fb(134)150 937 y Fe(prefix-meta)28 b(\(ESC\))17 b Fc(:)d(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 b Fb(135)150 1025 y Fe(previous-history)d(\(C-p\))23 @@ -21520,7 +21557,7 @@ b(\(\))19 b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g b Fc(:)14 b(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)22 b Fb(130)146 1824 y Fs(R)150 1941 y Fe(re-read-init-file)29 b(\(C-x)e(C-r\))15 b Fc(:)f(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)30 b Fb(134)150 2029 y Fe(redraw-current-line)g(\(\))22 +(:)g(:)g(:)g(:)30 b Fb(135)150 2029 y Fe(redraw-current-line)g(\(\))22 b Fc(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)36 b Fb(128)150 2117 y Fe(reverse-search-history)31 b(\(C-r\))24 b Fc(:)13 b(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) @@ -21544,7 +21581,7 @@ b Fc(:)j(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) b Fc(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)33 b Fb(131)150 3178 y Fe(shell-transpose-words)d (\(M-C-t\))22 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)35 b Fb(131)2025 264 y Fe(skip-csi-sequence)29 b(\(\))9 +(:)35 b Fb(132)2025 264 y Fe(skip-csi-sequence)29 b(\(\))9 b Fc(:)14 b(:)f(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(135)2025 351 y Fe(start-kbd-macro)29 b(\(C-x)d(\(\))8 b Fc(:)14 b(:)f(:)g(:)h(:)f(:)g @@ -21569,9 +21606,9 @@ b(\(C-u\))20 b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:) f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(131)2025 2178 y Fe (unix-word-rubout)29 b(\(C-w\))22 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)36 -b Fb(131)2025 2265 y Fe(upcase-word)28 b(\(M-u\))17 b +b Fb(132)2025 2265 y Fe(upcase-word)28 b(\(M-u\))17 b Fc(:)d(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)32 b Fb(130)2021 +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)32 b Fb(131)2021 2744 y Fs(Y)2025 2894 y Fe(yank)26 b(\(C-y\))18 b Fc(:)c(:)f(:)g(:)h(:) f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)33 |