1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474 |
- ;;; term.el --- general command interpreter in a window stuff
- ;; Copyright (C) 1988, 1990, 1992, 1994-1995, 2001-2015 Free Software
- ;; Foundation, Inc.
- ;; Author: Per Bothner <per@bothner.com>
- ;; Maintainer: Dan Nicolaescu <dann@ics.uci.edu>, Per Bothner <per@bothner.com>
- ;; Based on comint mode written by: Olin Shivers <shivers@cs.cmu.edu>
- ;; Keywords: processes
- ;; This file is part of GNU Emacs.
- ;; GNU Emacs is free software: you can redistribute it and/or modify
- ;; it under the terms of the GNU General Public License as published by
- ;; the Free Software Foundation, either version 3 of the License, or
- ;; (at your option) any later version.
- ;; GNU Emacs is distributed in the hope that it will be useful,
- ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
- ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- ;; GNU General Public License for more details.
- ;; You should have received a copy of the GNU General Public License
- ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
- ;; Marck 13 2001
- ;; Fixes for CJK support by Yong Lu <lyongu@yahoo.com>.
- ;; Dir/Hostname tracking and ANSI colorization by
- ;; Marco Melgazzi <marco@techie.com>.
- ;; To see what I've modified and where it came from search for '-mm'
- ;;; Commentary:
- ;; Speed considerations and a few caveats
- ;; --------------------------------------
- ;;
- ;; While the message passing and the colorization surely introduce some
- ;; overhead this has became so small that IMHO it is surely outweighed by
- ;; the benefits you get but, as usual, YMMV.
- ;;
- ;; Important caveat, when deciding the cursor/'gray keys' keycodes I had to
- ;; make a choice: on my Linux box this choice allows me to run all the
- ;; ncurses applications without problems but make these keys
- ;; incomprehensible to all the cursesX programs. Your mileage may vary so
- ;; you may consider changing the default 'emulation'. Just search for this
- ;; piece of code and modify it as you like:
- ;;
- ;; ;; Which would be better: "\e[A" or "\eOA"? readline accepts either.
- ;; ;; For my configuration it's definitely better \eOA but YMMV. -mm
- ;; ;; For example: vi works with \eOA while elm wants \e[A ...
- ;; (defun term-send-up () (interactive) (term-send-raw-string "\eOA"))
- ;; (defun term-send-down () (interactive) (term-send-raw-string "\eOB"))
- ;; (defun term-send-right () (interactive) (term-send-raw-string "\eOC"))
- ;; (defun term-send-left () (interactive) (term-send-raw-string "\eOD"))
- ;;
- ;;
- ;; IMPORTANT: additions & changes
- ;; ------------------------------
- ;;
- ;; With this enhanced ansi-term.el you will get a reliable mechanism of
- ;; directory/username/host tracking: the only drawback is that you will
- ;; have to modify your shell start-up script. It's worth it, believe me :).
- ;;
- ;; When you rlogin/su/telnet and the account you access has a modified
- ;; startup script, you will be able to access the remote files as usual
- ;; with C-x C-f, if it's needed you will have to enter a password,
- ;; otherwise the file should get loaded straight away.
- ;;
- ;; This is useful even if you work only on one host: it often happens that,
- ;; for maintenance reasons, you have to edit files 'as root': before
- ;; patching term.el, I su-ed in a term.el buffer and used vi :), now I
- ;; simply do a C-x C-f and, via ange-ftp, the file is automatically loaded
- ;; 'as-root'. ( If you don't want to enter the root password every time you
- ;; can put it in your .netrc: note that this is -not- advisable if you're
- ;; connected to the internet or if somebody else works on your workstation!)
- ;;
- ;; If you use wu-ftpd you can use some of its features to avoid root ftp
- ;; access to the rest of the world: just put in /etc/ftphosts something like
- ;;
- ;; # Local access
- ;; allow root 127.0.0.1
- ;;
- ;; # By default nobody can't do anything
- ;; deny root *
- ;;
- ;;
- ;; ----------------------------------------
- ;;
- ;; If, instead of 'term', you call 'ansi-term', you get multiple term
- ;; buffers, after every new call ansi-term opens a new *ansi-term*<xx> window,
- ;; where <xx> is, as usual, a number...
- ;;
- ;; ----------------------------------------
- ;;
- ;; With the term-buffer-maximum-size you can finally decide how many
- ;; scrollback lines to keep: its default is 2048 but you can change it as
- ;; usual.
- ;;
- ;; ----------------------------------------
- ;;
- ;;
- ;; ANSI colorization should work well, I've decided to limit the interpreter
- ;; to five outstanding commands (like ESC [ 01;04;32;41;07m.
- ;; You shouldn't need more, if you do, tell me and I'll increase it. It's
- ;; so easy you could do it yourself...
- ;;
- ;; Blink, is not supported. Currently it's mapped as bold.
- ;;
- ;; ----------------------------------------
- ;;
- ;; If you'd like to check out my complete configuration, you can download
- ;; it from http://www.polito.it/~s64912/things.html, it's ~500k in size and
- ;; contains my .cshrc, .emacs and my whole site-lisp subdirectory. (notice
- ;; that this term.el may be newer/older than the one in there, please
- ;; check!)
- ;;
- ;; This complete configuration contains, among other things, a complete
- ;; rectangular marking solution (based on rect-mark.el and
- ;; pc-bindings.el) and should be a good example of how extensively Emacs
- ;; can be configured on a ppp-connected ws.
- ;;
- ;; ----------------------------------------
- ;;
- ;; TODO:
- ;;
- ;; - Add hooks to allow raw-mode keys to be configurable
- ;; - Which keys are better ? \eOA or \e[A ?
- ;;
- ;;
- ;; Changes:
- ;;
- ;; V4.0 January 1997
- ;;
- ;; - Huge reworking of the faces code: now we only have roughly 20-30
- ;; faces for everything so we're even faster than the old md-term.el !
- ;; - Finished removing all the J-Shell code.
- ;;
- ;; V3.0 January 1997
- ;;
- ;; - Now all the supportable ANSI commands work well.
- ;; - Reworked a little the code: much less jsh-inspired stuff
- ;;
- ;; V2.3 November
- ;;
- ;; - Now all the faces are accessed through an array: much cleaner code.
- ;;
- ;; V2.2 November 4 1996
- ;;
- ;; - Implemented ANSI output colorization ( a bit rough but enough for
- ;; color_ls )
- ;;
- ;; - Implemented a maximum limit for the scroll buffer (stolen from
- ;; comint.el)
- ;;
- ;; v2.1 October 28 1996, first public release
- ;;
- ;; - Some new keybindings for term-char mode ( notably home/end/...)
- ;; - Directory, hostname and username tracking via ange-ftp
- ;; - Multi-term capability via the ansi-term call
- ;;
- ;; ----------------------------------------------------------------
- ;; You should/could have something like this in your .emacs to take
- ;; full advantage of this package
- ;;
- ;; (add-hook 'term-mode-hook
- ;; (function
- ;; (lambda ()
- ;; (setq term-prompt-regexp "^[^#$%>\n]*[#$%>] *")
- ;; (setq-local mouse-yank-at-point t)
- ;; (setq-local transient-mark-mode nil)
- ;; (auto-fill-mode -1)
- ;; (setq tab-width 8 ))))
- ;;
- ;;
- ;; ----------------------------------------
- ;;
- ;; If you want to use color ls the best setup is to have a different file
- ;; when you use eterm ( see above, mine is named .emacs_dircolors ). This
- ;; is necessary because some terminals, rxvt for example, need non-ansi
- ;; hacks to work ( for example on my rxvt white is wired to fg, and to
- ;; obtain normal white I have to do bold-white :)
- ;;
- ;; ----------------------------------------
- ;;
- ;;
- ;; # Configuration file for the color ls utility
- ;; # This file goes in the /etc directory, and must be world readable.
- ;; # You can copy this file to .dir_colors in your $HOME directory to
- ;; # override the system defaults.
- ;;
- ;; # COLOR needs one of these arguments: 'tty' colorizes output to ttys, but
- ;; # not pipes. 'all' adds color characters to all output. 'none' shuts
- ;; # colorization off.
- ;; COLOR tty
- ;; OPTIONS -F
- ;;
- ;; # Below, there should be one TERM entry for each termtype that is
- ;; # colorizable
- ;; TERM eterm
- ;;
- ;; # EIGHTBIT, followed by '1' for on, '0' for off. (8-bit output)
- ;; EIGHTBIT 1
- ;;
- ;; # Below are the color init strings for the basic file types. A color init
- ;; # string consists of one or more of the following numeric codes:
- ;; # Attribute codes:
- ;; # 00=none 01=bold 04=underscore 05=blink 07=reverse 08=concealed
- ;; # Text color codes:
- ;; # 30=black 31=red 32=green 33=yellow 34=blue 35=magenta 36=cyan 37=white
- ;; # Background color codes:
- ;; # 40=black 41=red 42=green 43=yellow 44=blue 45=magenta 46=cyan 47=white
- ;; NORMAL 00 # global default, although everything should be something.
- ;; FILE 00 # normal file
- ;; DIR 00;37 # directory
- ;; LINK 00;36 # symbolic link
- ;; FIFO 00;37 # pipe
- ;; SOCK 40;35 # socket
- ;; BLK 33;01 # block device driver
- ;; CHR 33;01 # character device driver
- ;;
- ;; # This is for files with execute permission:
- ;; EXEC 00;32
- ;;
- ;; # List any file extensions like '.gz' or '.tar' that you would like ls
- ;; # to colorize below. Put the extension, a space, and the color init
- ;; # string. (and any comments you want to add after a '#')
- ;; .tar 01;33 # archives or compressed
- ;; .tgz 01;33
- ;; .arj 01;33
- ;; .taz 01;33
- ;; .lzh 01;33
- ;; .zip 01;33
- ;; .z 01;33
- ;; .Z 01;33
- ;; .gz 01;33
- ;; .jpg 01;35 # image formats
- ;; .gif 01;35
- ;; .bmp 01;35
- ;; .xbm 01;35
- ;; .xpm 01;35
- ;;
- ;;
- ;; ----------------------------------------
- ;;
- ;; Notice: for directory/host/user tracking you need to have something
- ;; like this in your shell startup script (this is for a POSIXish shell
- ;; like Bash but should be quite easy to port to other shells)
- ;;
- ;; ----------------------------------------
- ;;
- ;; # Set HOSTNAME if not already set.
- ;; : ${HOSTNAME=$(uname -n)}
- ;;
- ;; # su does not change this but I'd like it to
- ;;
- ;; USER=$(whoami)
- ;;
- ;; # ...
- ;;
- ;; case $TERM in
- ;; eterm*)
- ;;
- ;; printf '%s\n' \
- ;; -------------------------------------------------------------- \
- ;; "Hello $user" \
- ;; "Today is $(date)" \
- ;; "We are on $HOSTNAME running $(uname) under Emacs term mode" \
- ;; --------------------------------------------------------------
- ;;
- ;; export EDITOR=emacsclient
- ;;
- ;; # The \033 stands for ESC.
- ;; # There is a space between "AnSiT?" and $whatever.
- ;;
- ;; cd() { command cd "$@"; printf '\033AnSiTc %s\n' "$PWD"; }
- ;; pushd() { command pushd "$@"; printf '\033AnSiTc %s\n' "$PWD"; }
- ;; popd() { command popd "$@"; printf '\033AnSiTc %s\n' "$PWD"; }
- ;;
- ;; printf '\033AnSiTc %s\n' "$PWD"
- ;; printf '\033AnSiTh %s\n' "$HOSTNAME"
- ;; printf '\033AnSiTu %s\n' "$USER"
- ;;
- ;; eval $(dircolors $HOME/.emacs_dircolors)
- ;; esac
- ;;
- ;; # ...
- ;;
- ;;
- ;;; Original Commentary:
- ;; ---------------------
- ;; The changelog is at the end of this file.
- ;; Please send me bug reports, bug fixes, and extensions, so that I can
- ;; merge them into the master source.
- ;; - Per Bothner (bothner@cygnus.com)
- ;; This file defines a general command-interpreter-in-a-buffer package
- ;; (term mode). The idea is that you can build specific process-in-a-buffer
- ;; modes on top of term mode -- e.g., lisp, shell, scheme, T, soar, ....
- ;; This way, all these specific packages share a common base functionality,
- ;; and a common set of bindings, which makes them easier to use (and
- ;; saves code, implementation time, etc., etc.).
- ;; For hints on converting existing process modes (e.g., tex-mode,
- ;; background, dbx, gdb, kermit, prolog, telnet) to use term-mode
- ;; instead of shell-mode, see the notes at the end of this file.
- ;; Brief Command Documentation:
- ;;============================================================================
- ;; Term Mode Commands: (common to all derived modes, like cmushell & cmulisp
- ;; mode)
- ;;
- ;; m-p term-previous-input Cycle backwards in input history
- ;; m-n term-next-input Cycle forwards
- ;; m-r term-previous-matching-input Previous input matching a regexp
- ;; m-s comint-next-matching-input Next input that matches
- ;; return term-send-input
- ;; c-c c-a term-bol Beginning of line; skip prompt.
- ;; c-d term-delchar-or-maybe-eof Delete char unless at end of buff.
- ;; c-c c-u term-kill-input ^u
- ;; c-c c-w backward-kill-word ^w
- ;; c-c c-c term-interrupt-subjob ^c
- ;; c-c c-z term-stop-subjob ^z
- ;; c-c c-\ term-quit-subjob ^\
- ;; c-c c-o term-kill-output Delete last batch of process output
- ;; c-c c-r term-show-output Show last batch of process output
- ;; c-c c-h term-dynamic-list-input-ring List input history
- ;;
- ;; Not bound by default in term-mode
- ;; term-send-invisible Read a line w/o echo, and send to proc
- ;; (These are bound in shell-mode)
- ;; term-dynamic-complete Complete filename at point.
- ;; term-dynamic-list-completions List completions in help buffer.
- ;; term-replace-by-expanded-filename Expand and complete filename at point;
- ;; replace with expanded/completed name.
- ;; term-kill-subjob No mercy.
- ;; term-show-maximum-output Show as much output as possible.
- ;; term-continue-subjob Send CONT signal to buffer's process
- ;; group. Useful if you accidentally
- ;; suspend your process (with C-c C-z).
- ;; term-mode-hook is the term mode hook. Basically for your keybindings.
- ;; term-load-hook is run after loading in this package.
- ;;; Code:
- ;; This is passed to the inferior in the EMACS environment variable,
- ;; so it is important to increase it if there are protocol-relevant changes.
- (defconst term-protocol-version "0.96")
- (eval-when-compile (require 'ange-ftp))
- (require 'ring)
- (require 'ehelp)
- (declare-function ring-empty-p "ring" (ring))
- (declare-function ring-ref "ring" (ring index))
- (declare-function ring-insert-at-beginning "ring" (ring item))
- (declare-function ring-length "ring" (ring))
- (declare-function ring-insert "ring" (ring item))
- (defgroup term nil
- "General command interpreter in a window."
- :group 'processes)
- ;;; Buffer Local Variables:
- ;;============================================================================
- ;; Term mode buffer local variables:
- ;; term-prompt-regexp - string term-bol uses to match prompt.
- ;; term-delimiter-argument-list - list For delimiters and arguments
- ;; term-last-input-start - marker Handy if inferior always echoes
- ;; term-last-input-end - marker For term-kill-output command
- ;; For the input history mechanism:
- (defvar term-input-ring-size 32 "Size of input history ring.")
- ;; term-input-ring-size - integer
- ;; term-input-ring - ring
- ;; term-input-ring-index - number ...
- ;; term-input-autoexpand - symbol ...
- ;; term-input-ignoredups - boolean ...
- ;; term-last-input-match - string ...
- ;; term-dynamic-complete-functions - hook For the completion mechanism
- ;; term-completion-fignore - list ...
- ;; term-get-old-input - function Hooks for specific
- ;; term-input-filter-functions - hook process-in-a-buffer
- ;; term-input-filter - function modes.
- ;; term-input-send - function
- ;; term-scroll-to-bottom-on-output - symbol ...
- ;; term-scroll-show-maximum-output - boolean...
- (defvar term-height) ; Number of lines in window.
- (defvar term-width) ; Number of columns in window.
- (defvar term-home-marker) ; Marks the "home" position for cursor addressing.
- (defvar term-saved-home-marker nil
- "When using alternate sub-buffer,
- contains saved term-home-marker from original sub-buffer.")
- (defvar term-start-line-column 0
- "(current-column) at start of screen line, or nil if unknown.")
- (defvar term-current-column 0 "If non-nil, is cache for (current-column).")
- (defvar term-current-row 0
- "Current vertical row (relative to home-marker) or nil if unknown.")
- (defvar term-insert-mode nil)
- (defvar term-vertical-motion)
- (defvar term-terminal-state 0
- "State of the terminal emulator:
- state 0: Normal state
- state 1: Last character was a graphic in the last column.
- If next char is graphic, first move one column right
- \(and line warp) before displaying it.
- This emulates (more or less) the behavior of xterm.
- state 2: seen ESC
- state 3: seen ESC [ (or ESC [ ?)
- state 4: term-terminal-parameter contains pending output.")
- (defvar term-kill-echo-list nil
- "A queue of strings whose echo we want suppressed.")
- (defvar term-terminal-parameter)
- (defvar term-terminal-previous-parameter)
- (defvar term-current-face 'term)
- (defvar term-scroll-start 0 "Top-most line (inclusive) of scrolling region.")
- (defvar term-scroll-end) ; Number of line (zero-based) after scrolling region.
- (defvar term-pager-count nil
- "Number of lines before we need to page; if nil, paging is disabled.")
- (defvar term-saved-cursor nil)
- (defvar term-command-hook)
- (defvar term-log-buffer nil)
- (defvar term-scroll-with-delete nil
- "If t, forward scrolling should be implemented by delete to
- top-most line(s); and if nil, scrolling should be implemented
- by moving term-home-marker. It is set to t if there is a
- \(non-default) scroll-region OR the alternate buffer is used.")
- (defvar term-pending-delete-marker) ; New user input in line mode
- ; needs to be deleted, because it gets echoed by the inferior.
- ; To reduce flicker, we defer the delete until the next output.
- (defvar term-old-mode-map nil "Saves the old keymap when in char mode.")
- (defvar term-old-mode-line-format) ; Saves old mode-line-format while paging.
- (defvar term-pager-old-local-map nil "Saves old keymap while paging.")
- (defvar term-pager-old-filter) ; Saved process-filter while paging.
- (defcustom explicit-shell-file-name nil
- "If non-nil, is file name to use for explicitly requested inferior shell."
- :type '(choice (const nil) file)
- :group 'term)
- (defvar term-prompt-regexp "^"
- "Regexp to recognize prompts in the inferior process.
- Defaults to \"^\", the null string at BOL.
- Good choices:
- Canonical Lisp: \"^[^> \\n]*>+:? *\" (Lucid, franz, kcl, T, cscheme, oaklisp)
- Lucid Common Lisp: \"^\\\\(>\\\\|\\\\(->\\\\)+\\\\) *\"
- franz: \"^\\\\(->\\\\|<[0-9]*>:\\\\) *\"
- kcl: \"^>+ *\"
- shell: \"^[^#$%>\\n]*[#$%>] *\"
- T: \"^>+ *\"
- This is a good thing to set in mode hooks.")
- (defvar term-delimiter-argument-list ()
- "List of characters to recognize as separate arguments in input.
- Strings comprising a character in this list will separate the arguments
- surrounding them, and also be regarded as arguments in their own right
- \(unlike whitespace). See `term-arguments'.
- Defaults to the empty list.
- For shells, a good value is (?\\| ?& ?< ?> ?\\( ?\\) ?\\;).
- This is a good thing to set in mode hooks.")
- (defcustom term-input-autoexpand nil
- "If non-nil, expand input command history references on completion.
- This mirrors the optional behavior of tcsh (its autoexpand and histlit).
- If the value is `input', then the expansion is seen on input.
- If the value is `history', then the expansion is only when inserting
- into the buffer's input ring. See also `term-magic-space' and
- `term-dynamic-complete'.
- This variable is buffer-local."
- :type '(choice (const nil) (const t) (const input) (const history))
- :group 'term)
- (defcustom term-input-ignoredups nil
- "If non-nil, don't add input matching the last on the input ring.
- This mirrors the optional behavior of bash.
- This variable is buffer-local."
- :type 'boolean
- :group 'term)
- (defcustom term-input-ring-file-name nil
- "If non-nil, name of the file to read/write input history.
- See also `term-read-input-ring' and `term-write-input-ring'.
- This variable is buffer-local, and is a good thing to set in mode hooks."
- :type 'boolean
- :group 'term)
- (defcustom term-scroll-to-bottom-on-output nil
- "Controls whether interpreter output causes window to scroll.
- If nil, then do not scroll. If t or `all', scroll all windows showing buffer.
- If `this', scroll only the selected window.
- If `others', scroll only those that are not the selected window.
- The default is nil.
- See variable `term-scroll-show-maximum-output'.
- This variable is buffer-local."
- :type 'boolean
- :group 'term)
- (defcustom term-scroll-show-maximum-output nil
- "Controls how interpreter output causes window to scroll.
- If non-nil, then show the maximum output when the window is scrolled.
- See variable `term-scroll-to-bottom-on-output'.
- This variable is buffer-local."
- :type 'boolean
- :group 'term)
- (defcustom term-suppress-hard-newline nil
- "Non-nil means interpreter should not break long lines with newlines.
- This means text can automatically reflow if the window is resized."
- :version "24.4"
- :type 'boolean
- :group 'term)
- ;; Where gud-display-frame should put the debugging arrow. This is
- ;; set by the marker-filter, which scans the debugger's output for
- ;; indications of the current pc.
- (defvar term-pending-frame nil)
- ;;; Here are the per-interpreter hooks.
- (defvar term-get-old-input (function term-get-old-input-default)
- "Function that submits old text in term mode.
- This function is called when return is typed while the point is in old text.
- It returns the text to be submitted as process input. The default is
- `term-get-old-input-default', which grabs the current line, and strips off
- leading text matching `term-prompt-regexp'.")
- (defvar term-dynamic-complete-functions
- '(term-replace-by-expanded-history term-dynamic-complete-filename)
- "List of functions called to perform completion.
- Functions should return non-nil if completion was performed.
- See also `term-dynamic-complete'.
- This is a good thing to set in mode hooks.")
- (defvar term-input-filter
- (function (lambda (str) (not (string-match "\\`\\s *\\'" str))))
- "Predicate for filtering additions to input history.
- Only inputs answering true to this function are saved on the input
- history list. Default is to save anything that isn't all whitespace.")
- (defvar term-input-filter-functions '()
- "Functions to call before input is sent to the process.
- These functions get one argument, a string containing the text to send.
- This variable is buffer-local.")
- (defvar term-input-sender (function term-simple-send)
- "Function to actually send to PROCESS the STRING submitted by user.
- Usually this is just `term-simple-send', but if your mode needs to
- massage the input string, this is your hook. This is called from
- the user command `term-send-input'. `term-simple-send' just sends
- the string plus a newline.")
- (defcustom term-eol-on-send t
- "Non-nil means go to the end of the line before sending input.
- See `term-send-input'."
- :type 'boolean
- :group 'term)
- (defcustom term-mode-hook '()
- "Called upon entry into term mode.
- This is run before the process is cranked up."
- :type 'hook
- :group 'term)
- (defcustom term-exec-hook '()
- "Called each time a process is exec'd by `term-exec'.
- This is called after the process is cranked up. It is useful for things that
- must be done each time a process is executed in a term mode buffer (e.g.,
- `process-kill-without-query'). In contrast, `term-mode-hook' is only
- executed once when the buffer is created."
- :type 'hook
- :group 'term)
- (defvar term-mode-map
- (let ((map (make-sparse-keymap)))
- (define-key map "\ep" 'term-previous-input)
- (define-key map "\en" 'term-next-input)
- (define-key map "\er" 'term-previous-matching-input)
- (define-key map "\es" 'term-next-matching-input)
- (unless (featurep 'xemacs)
- (define-key map [?\A-\M-r]
- 'term-previous-matching-input-from-input)
- (define-key map [?\A-\M-s] 'term-next-matching-input-from-input))
- (define-key map "\e\C-l" 'term-show-output)
- (define-key map "\C-m" 'term-send-input)
- (define-key map "\C-d" 'term-delchar-or-maybe-eof)
- (define-key map "\C-c\C-a" 'term-bol)
- (define-key map "\C-c\C-u" 'term-kill-input)
- (define-key map "\C-c\C-w" 'backward-kill-word)
- (define-key map "\C-c\C-c" 'term-interrupt-subjob)
- (define-key map "\C-c\C-z" 'term-stop-subjob)
- (define-key map "\C-c\C-\\" 'term-quit-subjob)
- (define-key map "\C-c\C-m" 'term-copy-old-input)
- (define-key map "\C-c\C-o" 'term-kill-output)
- (define-key map "\C-c\C-r" 'term-show-output)
- (define-key map "\C-c\C-e" 'term-show-maximum-output)
- (define-key map "\C-c\C-l" 'term-dynamic-list-input-ring)
- (define-key map "\C-c\C-n" 'term-next-prompt)
- (define-key map "\C-c\C-p" 'term-previous-prompt)
- (define-key map "\C-c\C-d" 'term-send-eof)
- (define-key map "\C-c\C-k" 'term-char-mode)
- (define-key map "\C-c\C-j" 'term-line-mode)
- (define-key map "\C-c\C-q" 'term-pager-toggle)
- ;; completion: (line mode only)
- (easy-menu-define nil map "Complete menu for Term mode."
- '("Complete"
- ["Complete Before Point" term-dynamic-complete t]
- ["Complete File Name" term-dynamic-complete-filename t]
- ["File Completion Listing" term-dynamic-list-filename-completions t]
- ["Expand File Name" term-replace-by-expanded-filename t]))
- ;; Input history: (line mode only)
- (easy-menu-define nil map "In/Out menu for Term mode."
- '("In/Out"
- ["Expand History Before Point" term-replace-by-expanded-history
- term-input-autoexpand]
- ["List Input History" term-dynamic-list-input-ring t]
- ["Previous Input" term-previous-input t]
- ["Next Input" term-next-input t]
- ["Previous Matching Current Input"
- term-previous-matching-input-from-input t]
- ["Next Matching Current Input" term-next-matching-input-from-input t]
- ["Previous Matching Input..." term-previous-matching-input t]
- ["Next Matching Input..." term-next-matching-input t]
- ["Backward Matching Input..." term-backward-matching-input t]
- ["Forward Matching Input..." term-forward-matching-input t]
- ["Copy Old Input" term-copy-old-input t]
- ["Kill Current Input" term-kill-input t]
- ["Show Current Output Group" term-show-output t]
- ["Show Maximum Output" term-show-maximum-output t]
- ["Backward Output Group" term-previous-prompt t]
- ["Forward Output Group" term-next-prompt t]
- ["Kill Current Output Group" term-kill-output t]))
- map)
- "Keymap for Term mode.")
- (defvar term-escape-char nil
- "Escape character for char sub-mode of term mode.
- Do not change it directly; use `term-set-escape-char' instead.")
- (defvar term-pager-break-map
- (let ((map (make-keymap)))
- ;; (dotimes (i 128)
- ;; (define-key map (make-string 1 i) 'term-send-raw))
- (define-key map "\e" (lookup-key (current-global-map) "\e"))
- (define-key map "\C-x" (lookup-key (current-global-map) "\C-x"))
- (define-key map "\C-u" (lookup-key (current-global-map) "\C-u"))
- (define-key map " " 'term-pager-page)
- (define-key map "\r" 'term-pager-line)
- (define-key map "?" 'term-pager-help)
- (define-key map "h" 'term-pager-help)
- (define-key map "b" 'term-pager-back-page)
- (define-key map "\177" 'term-pager-back-line)
- (define-key map "q" 'term-pager-discard)
- (define-key map "D" 'term-pager-disable)
- (define-key map "<" 'term-pager-bob)
- (define-key map ">" 'term-pager-eob)
- map)
- "Keymap used in Term pager mode.")
- (defvar term-ptyp t
- "True if communications via pty; false if by pipe. Buffer local.
- This is to work around a bug in Emacs process signaling.")
- (defvar term-last-input-match ""
- "Last string searched for by term input history search, for defaulting.
- Buffer local variable.")
- (defvar term-input-ring nil)
- (defvar term-last-input-start)
- (defvar term-last-input-end)
- (defvar term-input-ring-index nil
- "Index of last matched history element.")
- (defvar term-matching-input-from-input-string ""
- "Input previously used to match input history.")
- ; This argument to set-process-filter disables reading from the process,
- ; assuming this is Emacs 19.20 or newer.
- (defvar term-pager-filter t)
- (put 'term-input-ring 'permanent-local t)
- (put 'term-input-ring-index 'permanent-local t)
- (put 'term-input-autoexpand 'permanent-local t)
- (put 'term-input-filter-functions 'permanent-local t)
- (put 'term-scroll-to-bottom-on-output 'permanent-local t)
- (put 'term-scroll-show-maximum-output 'permanent-local t)
- (put 'term-ptyp 'permanent-local t)
- (defmacro term-in-char-mode () '(eq (current-local-map) term-raw-map))
- (defmacro term-in-line-mode () '(not (term-in-char-mode)))
- ;; True if currently doing PAGER handling.
- (defmacro term-pager-enabled () 'term-pager-count)
- (defmacro term-handling-pager () 'term-pager-old-local-map)
- (defmacro term-using-alternate-sub-buffer () 'term-saved-home-marker)
- ;; Let's silence the byte-compiler -mm
- (defvar term-ansi-at-host nil)
- (defvar term-ansi-at-dir nil)
- (defvar term-ansi-at-user nil)
- (defvar term-ansi-at-message nil)
- (defvar term-ansi-at-save-user nil)
- (defvar term-ansi-at-save-pwd nil)
- (defvar term-ansi-at-save-anon nil)
- (defvar term-ansi-current-bold nil)
- (defvar term-ansi-current-color 0)
- (defvar term-ansi-face-already-done nil)
- (defvar term-ansi-current-bg-color 0)
- (defvar term-ansi-current-underline nil)
- (defvar term-ansi-current-reverse nil)
- (defvar term-ansi-current-invisible nil)
- ;; Four should be enough, if you want more, just add. -mm
- (defvar term-terminal-more-parameters 0)
- (defvar term-terminal-previous-parameter-2 -1)
- (defvar term-terminal-previous-parameter-3 -1)
- (defvar term-terminal-previous-parameter-4 -1)
- ;;; Faces
- (defvar ansi-term-color-vector
- [term
- term-color-black
- term-color-red
- term-color-green
- term-color-yellow
- term-color-blue
- term-color-magenta
- term-color-cyan
- term-color-white])
- (defcustom term-default-fg-color nil
- "If non-nil, default color for foreground in Term mode."
- :group 'term
- :type '(choice (const nil) (string :tag "color")))
- (make-obsolete-variable 'term-default-fg-color "use the face `term' instead."
- "24.3")
- (defcustom term-default-bg-color nil
- "If non-nil, default color for foreground in Term mode."
- :group 'term
- :type '(choice (const nil) (string :tag "color")))
- (make-obsolete-variable 'term-default-bg-color "use the face `term' instead."
- "24.3")
- (defface term
- `((t
- :foreground ,term-default-fg-color
- :background ,term-default-bg-color
- :inherit default))
- "Default face to use in Term mode."
- :group 'term)
- (defface term-bold
- '((t :bold t))
- "Default face to use for bold text."
- :group 'term)
- (defface term-underline
- '((t :underline t))
- "Default face to use for underlined text."
- :group 'term)
- (defface term-color-black
- '((t :foreground "black" :background "black"))
- "Face used to render black color code."
- :group 'term)
- (defface term-color-red
- '((t :foreground "red3" :background "red3"))
- "Face used to render red color code."
- :group 'term)
- (defface term-color-green
- '((t :foreground "green3" :background "green3"))
- "Face used to render green color code."
- :group 'term)
- (defface term-color-yellow
- '((t :foreground "yellow3" :background "yellow3"))
- "Face used to render yellow color code."
- :group 'term)
- (defface term-color-blue
- '((t :foreground "blue2" :background "blue2"))
- "Face used to render blue color code."
- :group 'term)
- (defface term-color-magenta
- '((t :foreground "magenta3" :background "magenta3"))
- "Face used to render magenta color code."
- :group 'term)
- (defface term-color-cyan
- '((t :foreground "cyan3" :background "cyan3"))
- "Face used to render cyan color code."
- :group 'term)
- (defface term-color-white
- '((t :foreground "white" :background "white"))
- "Face used to render white color code."
- :group 'term)
- ;; Inspiration came from comint.el -mm
- (defcustom term-buffer-maximum-size 2048
- "The maximum size in lines for term buffers.
- Term buffers are truncated from the top to be no greater than this number.
- Notice that a setting of 0 means \"don't truncate anything\". This variable
- is buffer-local."
- :group 'term
- :type 'integer)
- ;; Set up term-raw-map, etc.
- (defvar term-raw-map
- (let* ((map (make-keymap))
- (esc-map (make-keymap))
- (i 0))
- (while (< i 128)
- (define-key map (make-string 1 i) 'term-send-raw)
- ;; Avoid O and [. They are used in escape sequences for various keys.
- (unless (or (eq i ?O) (eq i 91))
- (define-key esc-map (make-string 1 i) 'term-send-raw-meta))
- (setq i (1+ i)))
- (define-key map [remap self-insert-command] 'term-send-raw)
- (define-key map "\e" esc-map)
- ;; Added nearly all the 'gray keys' -mm
- (if (featurep 'xemacs)
- (define-key map [button2] 'term-mouse-paste)
- (define-key map [mouse-2] 'term-mouse-paste))
- (define-key map [up] 'term-send-up)
- (define-key map [down] 'term-send-down)
- (define-key map [right] 'term-send-right)
- (define-key map [left] 'term-send-left)
- (define-key map [delete] 'term-send-del)
- (define-key map [deletechar] 'term-send-del)
- (define-key map [backspace] 'term-send-backspace)
- (define-key map [home] 'term-send-home)
- (define-key map [end] 'term-send-end)
- (define-key map [insert] 'term-send-insert)
- (define-key map [S-prior] 'scroll-down)
- (define-key map [S-next] 'scroll-up)
- (define-key map [S-insert] 'term-paste)
- (define-key map [prior] 'term-send-prior)
- (define-key map [next] 'term-send-next)
- map)
- "Keyboard map for sending characters directly to the inferior process.")
- (easy-menu-define term-terminal-menu
- (list term-mode-map term-raw-map term-pager-break-map)
- "Terminal menu for Term mode."
- '("Terminal"
- ["Line mode" term-line-mode :active (term-in-char-mode)
- :help "Switch to line (cooked) sub-mode of term mode"]
- ["Character mode" term-char-mode :active (term-in-line-mode)
- :help "Switch to char (raw) sub-mode of term mode"]
- ["Paging" term-pager-toggle :style toggle :selected term-pager-count
- :help "Toggle paging feature"]))
- (easy-menu-define term-signals-menu
- (list term-mode-map term-raw-map term-pager-break-map)
- "Signals menu for Term mode."
- '("Signals"
- ["BREAK" term-interrupt-subjob :active t
- :help "Interrupt the current subjob"]
- ["STOP" term-stop-subjob :active t :help "Stop the current subjob"]
- ["CONT" term-continue-subjob :active t
- :help "Send CONT signal to process buffer's process group"]
- ["QUIT" term-quit-subjob :active t
- :help "Send quit signal to the current subjob"]
- ["KILL" term-kill-subjob :active t
- :help "Send kill signal to the current subjob"]
- ["EOF" term-send-eof :active t
- :help "Send an EOF to the current buffer's process"]))
- (easy-menu-define term-pager-menu term-pager-break-map
- "Menu for Term pager mode."
- '("More pages?"
- ["1 page forwards" term-pager-page t]
- ["1 page backwards" term-pager-back-page t]
- ["1 line backwards" term-pager-back-line t]
- ["1 line forwards" term-pager-line t]
- ["Goto to beginning" term-pager-bob t]
- ["Goto to end" term-pager-eob t]
- ["Discard remaining output" term-pager-discard t]
- ["Disable paging" term-pager-toggle t]
- ["Help" term-pager-help t]))
- (defvar term-raw-escape-map
- (let ((map (make-sparse-keymap)))
- (set-keymap-parent map 'Control-X-prefix)
- ;; Define standard bindings in term-raw-escape-map.
- (define-key map "\C-v" (lookup-key (current-global-map) "\C-v"))
- (define-key map "\C-u" (lookup-key (current-global-map) "\C-u"))
- (define-key map "\C-q" 'term-pager-toggle)
- ;; The keybinding for term-char-mode is needed by the menubar code.
- (define-key map "\C-k" 'term-char-mode)
- (define-key map "\C-j" 'term-line-mode)
- ;; It's convenient to have execute-extended-command here.
- (define-key map [?\M-x] 'execute-extended-command)
- map))
- (defun term-set-escape-char (key)
- "Change `term-escape-char' and keymaps that depend on it."
- (when term-escape-char
- ;; Undo previous term-set-escape-char.
- (define-key term-raw-map term-escape-char 'term-send-raw))
- (setq term-escape-char (if (vectorp key) key (vector key)))
- (define-key term-raw-map term-escape-char term-raw-escape-map)
- ;; FIXME: If we later call term-set-escape-char again with another key,
- ;; we should undo this binding.
- (define-key term-raw-escape-map term-escape-char 'term-send-raw))
- (term-set-escape-char (or term-escape-char ?\C-c))
- (defvar overflow-newline-into-fringe)
- (defun term-window-width ()
- (if (and (not (featurep 'xemacs))
- (display-graphic-p)
- overflow-newline-into-fringe
- ;; Subtract 1 from the width when any fringe has zero width,
- ;; not just the right fringe. Bug#18601.
- (/= (frame-parameter nil 'left-fringe) 0)
- (/= (frame-parameter nil 'right-fringe) 0))
- (window-body-width)
- (1- (window-body-width))))
- (put 'term-mode 'mode-class 'special)
- ;; Use this variable as a display table for `term-mode'.
- (defvar term-display-table
- (let ((dt (or (copy-sequence standard-display-table)
- (make-display-table)))
- i)
- ;; avoid changing the display table for ^J
- (setq i 0)
- (while (< i 10)
- (aset dt i (vector i))
- (setq i (1+ i)))
- (setq i 11)
- (while (< i 32)
- (aset dt i (vector i))
- (setq i (1+ i)))
- (setq i 128)
- (while (< i 256)
- (aset dt i (vector i))
- (setq i (1+ i)))
- dt))
- (defun term-ansi-reset ()
- (setq term-current-face 'term)
- (setq term-ansi-current-underline nil)
- (setq term-ansi-current-bold nil)
- (setq term-ansi-current-reverse nil)
- (setq term-ansi-current-color 0)
- (setq term-ansi-current-invisible nil)
- ;; Stefan thought this should be t, but could not remember why.
- ;; Setting it to t seems to cause bug#11785. Setting it to nil
- ;; again to see if there are other consequences...
- (setq term-ansi-face-already-done nil)
- (setq term-ansi-current-bg-color 0))
- (define-derived-mode term-mode fundamental-mode "Term"
- "Major mode for interacting with an inferior interpreter.
- The interpreter name is same as buffer name, sans the asterisks.
- There are two submodes: line mode and char mode. By default, you are
- in char mode. In char sub-mode, each character (except
- `term-escape-char') is sent immediately to the subprocess.
- The escape character is equivalent to the usual meaning of C-x.
- In line mode, you send a line of input at a time; use
- \\[term-send-input] to send.
- In line mode, this maintains an input history of size
- `term-input-ring-size', and you can access it with the commands
- \\[term-next-input], \\[term-previous-input], and
- \\[term-dynamic-list-input-ring]. Input ring history expansion can be
- achieved with the commands \\[term-replace-by-expanded-history] or
- \\[term-magic-space]. Input ring expansion is controlled by the
- variable `term-input-autoexpand', and addition is controlled by the
- variable `term-input-ignoredups'.
- Input to, and output from, the subprocess can cause the window to scroll to
- the end of the buffer. See variables `term-scroll-to-bottom-on-input',
- and `term-scroll-to-bottom-on-output'.
- If you accidentally suspend your process, use \\[term-continue-subjob]
- to continue it.
- This mode can be customized to create specific modes for running
- particular subprocesses. This can be done by setting the hooks
- `term-input-filter-functions', `term-input-filter',
- `term-input-sender' and `term-get-old-input' to appropriate functions,
- and the variable `term-prompt-regexp' to the appropriate regular
- expression.
- Commands in raw mode:
- \\{term-raw-map}
- Commands in line mode:
- \\{term-mode-map}
- Entry to this mode runs the hooks on `term-mode-hook'."
- ;; we do not want indent to sneak in any tabs
- (setq indent-tabs-mode nil)
- (setq buffer-display-table term-display-table)
- (set (make-local-variable 'term-home-marker) (copy-marker 0))
- (set (make-local-variable 'term-height) (1- (window-height)))
- (set (make-local-variable 'term-width) (term-window-width))
- (set (make-local-variable 'term-last-input-start) (make-marker))
- (set (make-local-variable 'term-last-input-end) (make-marker))
- (set (make-local-variable 'term-last-input-match) "")
- (set (make-local-variable 'term-command-hook)
- (symbol-function 'term-command-hook))
- ;; These local variables are set to their local values:
- (make-local-variable 'term-saved-home-marker)
- (make-local-variable 'term-terminal-parameter)
- (make-local-variable 'term-saved-cursor)
- (make-local-variable 'term-prompt-regexp)
- (make-local-variable 'term-input-ring-size)
- (make-local-variable 'term-input-ring)
- (make-local-variable 'term-input-ring-file-name)
- (make-local-variable 'term-input-ring-index)
- (unless term-input-ring
- (setq term-input-ring (make-ring term-input-ring-size)))
- ;; I'm not sure these saves are necessary but, since I
- ;; haven't tested the whole thing on a net connected machine with
- ;; a properly configured ange-ftp, I've decided to be conservative
- ;; and put them in. -mm
- (set (make-local-variable 'term-ansi-at-host) (system-name))
- (set (make-local-variable 'term-ansi-at-dir) default-directory)
- (set (make-local-variable 'term-ansi-at-message) nil)
- ;; For user tracking purposes -mm
- (make-local-variable 'ange-ftp-default-user)
- (make-local-variable 'ange-ftp-default-password)
- (make-local-variable 'ange-ftp-generate-anonymous-password)
- ;; You may want to have different scroll-back sizes -mm
- (make-local-variable 'term-buffer-maximum-size)
- ;; Of course these have to be buffer-local -mm
- (make-local-variable 'term-ansi-current-bold)
- (make-local-variable 'term-ansi-current-color)
- (make-local-variable 'term-ansi-face-already-done)
- (make-local-variable 'term-ansi-current-bg-color)
- (make-local-variable 'term-ansi-current-underline)
- (make-local-variable 'term-ansi-current-reverse)
- (make-local-variable 'term-ansi-current-invisible)
- (make-local-variable 'term-terminal-parameter)
- (make-local-variable 'term-terminal-previous-parameter)
- (make-local-variable 'term-terminal-previous-parameter-2)
- (make-local-variable 'term-terminal-previous-parameter-3)
- (make-local-variable 'term-terminal-previous-parameter-4)
- (make-local-variable 'term-terminal-more-parameters)
- (make-local-variable 'term-terminal-state)
- (make-local-variable 'term-kill-echo-list)
- (make-local-variable 'term-start-line-column)
- (make-local-variable 'term-current-column)
- (make-local-variable 'term-current-row)
- (make-local-variable 'term-log-buffer)
- (make-local-variable 'term-scroll-start)
- (set (make-local-variable 'term-scroll-end) term-height)
- (make-local-variable 'term-scroll-with-delete)
- (make-local-variable 'term-pager-count)
- (make-local-variable 'term-pager-old-local-map)
- (make-local-variable 'term-old-mode-map)
- (make-local-variable 'term-insert-mode)
- (make-local-variable 'term-dynamic-complete-functions)
- (make-local-variable 'term-completion-fignore)
- (make-local-variable 'term-get-old-input)
- (make-local-variable 'term-matching-input-from-input-string)
- (make-local-variable 'term-input-autoexpand)
- (make-local-variable 'term-input-ignoredups)
- (make-local-variable 'term-delimiter-argument-list)
- (make-local-variable 'term-input-filter-functions)
- (make-local-variable 'term-input-filter)
- (make-local-variable 'term-input-sender)
- (make-local-variable 'term-eol-on-send)
- (make-local-variable 'term-scroll-to-bottom-on-output)
- (make-local-variable 'term-scroll-show-maximum-output)
- (make-local-variable 'term-ptyp)
- (make-local-variable 'term-exec-hook)
- (set (make-local-variable 'term-vertical-motion) 'vertical-motion)
- (set (make-local-variable 'term-pending-delete-marker) (make-marker))
- (make-local-variable 'term-current-face)
- (term-ansi-reset)
- (set (make-local-variable 'term-pending-frame) nil)
- ;; Cua-mode's keybindings interfere with the term keybindings, disable it.
- (set (make-local-variable 'cua-mode) nil)
- (set (make-local-variable 'font-lock-defaults) '(nil t))
- (add-function :filter-return
- (local 'window-adjust-process-window-size-function)
- (lambda (size)
- (when size
- (term-reset-size (cdr size) (car size)))
- size))
- (easy-menu-add term-terminal-menu)
- (easy-menu-add term-signals-menu)
- (or term-input-ring
- (setq term-input-ring (make-ring term-input-ring-size)))
- (term-update-mode-line))
- (defun term-reset-size (height width)
- (setq term-height height)
- (setq term-width width)
- (setq term-start-line-column nil)
- (setq term-current-row nil)
- (setq term-current-column nil)
- (term-set-scroll-region 0 height))
- ;; Recursive routine used to check if any string in term-kill-echo-list
- ;; matches part of the buffer before point.
- ;; If so, delete that matched part of the buffer - this suppresses echo.
- ;; Also, remove that string from the term-kill-echo-list.
- ;; We *also* remove any older string on the list, as a sanity measure,
- ;; in case something gets out of sync. (Except for type-ahead, there
- ;; should only be one element in the list.)
- (defun term-check-kill-echo-list ()
- (let ((cur term-kill-echo-list) (found nil) (save-point (point)))
- (unwind-protect
- (progn
- (end-of-line)
- (while cur
- (let* ((str (car cur)) (len (length str)) (start (- (point) len)))
- (if (and (>= start (point-min))
- (string= str (buffer-substring start (point))))
- (progn (delete-char (- len))
- (setq term-kill-echo-list (cdr cur))
- (setq term-current-column nil)
- (setq term-current-row nil)
- (setq term-start-line-column nil)
- (setq cur nil found t))
- (setq cur (cdr cur))))))
- (when (not found)
- (goto-char save-point)))
- found))
- (defun term-send-raw-string (chars)
- (deactivate-mark)
- (let ((proc (get-buffer-process (current-buffer))))
- (if (not proc)
- (error "Current buffer has no process")
- ;; Note that (term-current-row) must be called *after*
- ;; (point) has been updated to (process-mark proc).
- (goto-char (process-mark proc))
- (when (term-pager-enabled)
- (setq term-pager-count (term-current-row)))
- (process-send-string proc chars))))
- (defun term-send-raw ()
- "Send the last character typed through the terminal-emulator
- without any interpretation."
- (interactive)
- (let ((keys (this-command-keys)))
- (term-send-raw-string (string (aref keys (1- (length keys)))))))
- (defun term-send-raw-meta ()
- (interactive)
- (let ((char last-input-event))
- (when (symbolp char)
- ;; Convert `return' to C-m, etc.
- (let ((tmp (get char 'event-symbol-elements)))
- (if tmp (setq char (car tmp)))
- (and (symbolp char)
- (setq tmp (get char 'ascii-character))
- (setq char tmp))))
- (when (numberp char)
- (let ((base (event-basic-type char))
- (mods (delq 'meta (event-modifiers char))))
- (if (memq 'control mods)
- (setq mods (delq 'shift mods)))
- (term-send-raw-string
- (format "\e%c"
- (event-convert-list (append mods (list base)))))))))
- (defun term-mouse-paste (click)
- "Insert the primary selection at the position clicked on."
- (interactive "e")
- (if (featurep 'xemacs)
- (term-send-raw-string
- (or (condition-case () (x-get-selection) (error ()))
- (error "No selection available")))
- ;; Give temporary modes such as isearch a chance to turn off.
- (run-hooks 'mouse-leave-buffer-hook)
- (setq this-command 'yank)
- (mouse-set-point click)
- (term-send-raw-string (gui-get-primary-selection))))
- (defun term-paste ()
- "Insert the last stretch of killed text at point."
- (interactive)
- (term-send-raw-string (current-kill 0)))
- ;; Which would be better: "\e[A" or "\eOA"? readline accepts either.
- ;; For my configuration it's definitely better \eOA but YMMV. -mm
- ;; For example: vi works with \eOA while elm wants \e[A ...
- ;; (terminfo: kcuu1, kcud1, kcuf1, kcub1, khome, kend, kpp, knp, kdch1, kbs)
- (defun term-send-up () (interactive) (term-send-raw-string "\eOA"))
- (defun term-send-down () (interactive) (term-send-raw-string "\eOB"))
- (defun term-send-right () (interactive) (term-send-raw-string "\eOC"))
- (defun term-send-left () (interactive) (term-send-raw-string "\eOD"))
- (defun term-send-home () (interactive) (term-send-raw-string "\e[1~"))
- (defun term-send-insert() (interactive) (term-send-raw-string "\e[2~"))
- (defun term-send-end () (interactive) (term-send-raw-string "\e[4~"))
- (defun term-send-prior () (interactive) (term-send-raw-string "\e[5~"))
- (defun term-send-next () (interactive) (term-send-raw-string "\e[6~"))
- (defun term-send-del () (interactive) (term-send-raw-string "\e[3~"))
- (defun term-send-backspace () (interactive) (term-send-raw-string "\C-?"))
- (defun term-char-mode ()
- "Switch to char (\"raw\") sub-mode of term mode.
- Each character you type is sent directly to the inferior without
- intervention from Emacs, except for the escape character (usually C-c)."
- (interactive)
- ;; FIXME: Emit message? Cfr ilisp-raw-message
- (when (term-in-line-mode)
- (setq term-old-mode-map (current-local-map))
- (use-local-map term-raw-map)
- (easy-menu-add term-terminal-menu)
- (easy-menu-add term-signals-menu)
- ;; Send existing partial line to inferior (without newline).
- (let ((pmark (process-mark (get-buffer-process (current-buffer))))
- (save-input-sender term-input-sender))
- (when (> (point) pmark)
- (unwind-protect
- (progn
- (setq term-input-sender
- (symbol-function 'term-send-string))
- (end-of-line)
- (term-send-input))
- (setq term-input-sender save-input-sender))))
- (term-update-mode-line)))
- (defun term-line-mode ()
- "Switch to line (\"cooked\") sub-mode of term mode.
- This means that Emacs editing commands work as normally, until
- you type \\[term-send-input] which sends the current line to the inferior."
- (interactive)
- (when (term-in-char-mode)
- (use-local-map term-old-mode-map)
- (term-update-mode-line)))
- (defun term-update-mode-line ()
- (let ((term-mode
- (if (term-in-char-mode)
- (propertize "char"
- 'help-echo "mouse-1: Switch to line mode"
- 'mouse-face 'mode-line-highlight
- 'local-map
- '(keymap
- (mode-line keymap (down-mouse-1 . term-line-mode))))
- (propertize "line"
- 'help-echo "mouse-1: Switch to char mode"
- 'mouse-face 'mode-line-highlight
- 'local-map
- '(keymap
- (mode-line keymap (down-mouse-1 . term-char-mode))))))
- (term-page
- (when (term-pager-enabled)
- (concat " "
- (propertize
- "page"
- 'help-echo "mouse-1: Disable paging"
- 'mouse-face 'mode-line-highlight
- 'local-map
- '(keymap
- (mode-line keymap (down-mouse-1 .
- term-pager-toggle)))))))
- (serial-item-speed)
- (serial-item-config)
- (proc (get-buffer-process (current-buffer))))
- (when (and (term-check-proc (current-buffer))
- (equal (process-type nil) 'serial))
- (let ((temp (serial-speed)))
- (setq serial-item-speed
- `(:propertize
- ,(or (and temp (format " %d" temp)) "")
- help-echo "mouse-1: Change the speed of the serial port"
- mouse-face mode-line-highlight
- local-map (keymap (mode-line keymap
- (down-mouse-1 . serial-mode-line-speed-menu-1))))))
- (let ((temp (process-contact proc :summary)))
- (setq serial-item-config
- `(:propertize
- ,(or (and temp (format " %s" temp)) "")
- help-echo "mouse-1: Change the configuration of the serial port"
- mouse-face mode-line-highlight
- local-map (keymap (mode-line keymap
- (down-mouse-1 . serial-mode-line-config-menu-1)))))))
- (setq mode-line-process
- (list ": " term-mode term-page
- serial-item-speed
- serial-item-config
- " %s")))
- (force-mode-line-update))
- (defun term-check-proc (buffer)
- "True if there is a process associated w/buffer BUFFER, and it
- is alive. BUFFER can be either a buffer or the name of one."
- (let ((proc (get-buffer-process buffer)))
- (and proc (memq (process-status proc) '(run stop open listen connect)))))
- ;;;###autoload
- (defun make-term (name program &optional startfile &rest switches)
- "Make a term process NAME in a buffer, running PROGRAM.
- The name of the buffer is made by surrounding NAME with `*'s.
- If there is already a running process in that buffer, it is not restarted.
- Optional third arg STARTFILE is the name of a file to send the contents of to
- the process. Any more args are arguments to PROGRAM."
- (let ((buffer (get-buffer-create (concat "*" name "*"))))
- ;; If no process, or nuked process, crank up a new one and put buffer in
- ;; term mode. Otherwise, leave buffer and existing process alone.
- (cond ((not (term-check-proc buffer))
- (with-current-buffer buffer
- (term-mode)) ; Install local vars, mode, keymap, ...
- (term-exec buffer name program startfile switches)))
- buffer))
- ;;;###autoload
- (defun term (program)
- "Start a terminal-emulator in a new buffer.
- The buffer is in Term mode; see `term-mode' for the
- commands to use in that buffer.
- \\<term-raw-map>Type \\[switch-to-buffer] to switch to another buffer."
- (interactive (list (read-from-minibuffer "Run program: "
- (or explicit-shell-file-name
- (getenv "ESHELL")
- (getenv "SHELL")
- "/bin/sh"))))
- (set-buffer (make-term "terminal" program))
- (term-mode)
- (term-char-mode)
- (switch-to-buffer "*terminal*"))
- (defun term-exec (buffer name command startfile switches)
- "Start up a process in buffer for term modes.
- Blasts any old process running in the buffer. Doesn't set the buffer mode.
- You can use this to cheaply run a series of processes in the same term
- buffer. The hook `term-exec-hook' is run after each exec."
- (with-current-buffer buffer
- (let ((proc (get-buffer-process buffer))) ; Blast any old process.
- (when proc (delete-process proc)))
- ;; Crank up a new process
- (let ((proc (term-exec-1 name buffer command switches)))
- (make-local-variable 'term-ptyp)
- (setq term-ptyp process-connection-type) ; t if pty, nil if pipe.
- ;; Jump to the end, and set the process mark.
- (goto-char (point-max))
- (set-marker (process-mark proc) (point))
- (set-process-filter proc 'term-emulate-terminal)
- (set-process-sentinel proc 'term-sentinel)
- ;; Feed it the startfile.
- (when startfile
- ;;This is guaranteed to wait long enough
- ;;but has bad results if the term does not prompt at all
- ;; (while (= size (buffer-size))
- ;; (sleep-for 1))
- ;;I hope 1 second is enough!
- (sleep-for 1)
- (goto-char (point-max))
- (insert-file-contents startfile)
- (term-send-string
- proc (delete-and-extract-region (point) (point-max)))))
- (run-hooks 'term-exec-hook)
- buffer))
- (defun term-sentinel (proc msg)
- "Sentinel for term buffers.
- The main purpose is to get rid of the local keymap."
- (let ((buffer (process-buffer proc)))
- (when (memq (process-status proc) '(signal exit))
- (if (null (buffer-name buffer))
- ;; buffer killed
- (set-process-buffer proc nil)
- (with-current-buffer buffer
- ;; Write something in the compilation buffer
- ;; and hack its mode line.
- ;; Get rid of local keymap.
- (use-local-map nil)
- (term-handle-exit (process-name proc) msg)
- ;; Since the buffer and mode line will show that the
- ;; process is dead, we can delete it now. Otherwise it
- ;; will stay around until M-x list-processes.
- (delete-process proc))))))
- (defun term-handle-exit (process-name msg)
- "Write process exit (or other change) message MSG in the current buffer."
- (let ((buffer-read-only nil)
- (omax (point-max))
- (opoint (point)))
- ;; Record where we put the message, so we can ignore it
- ;; later on.
- (goto-char omax)
- (insert ?\n "Process " process-name " " msg)
- ;; Force mode line redisplay soon.
- (force-mode-line-update)
- (when (and opoint (< opoint omax))
- (goto-char opoint))))
- (defvar term-term-name "eterm-color"
- "Name to use for TERM.
- Using \"emacs\" loses, because bash disables editing if $TERM == emacs.")
- ;; Format string, usage:
- ;; (format term-termcap-string emacs-term-name "TERMCAP=" 24 80)
- (defvar term-termcap-format
- "%s%s:li#%d:co#%d:cl=\\E[H\\E[J:cd=\\E[J:bs:am:xn:cm=\\E[%%i%%d;%%dH\
- :nd=\\E[C:up=\\E[A:ce=\\E[K:ho=\\E[H:pt\
- :al=\\E[L:dl=\\E[M:DL=\\E[%%dM:AL=\\E[%%dL:cs=\\E[%%i%%d;%%dr:sf=^J\
- :dc=\\E[P:DC=\\E[%%dP:IC=\\E[%%d@:im=\\E[4h:ei=\\E[4l:mi:\
- :so=\\E[7m:se=\\E[m:us=\\E[4m:ue=\\E[m:md=\\E[1m:mr=\\E[7m:me=\\E[m\
- :UP=\\E[%%dA:DO=\\E[%%dB:LE=\\E[%%dD:RI=\\E[%%dC\
- :kl=\\EOD:kd=\\EOB:kr=\\EOC:ku=\\EOA:kN=\\E[6~:kP=\\E[5~:@7=\\E[4~:kh=\\E[1~\
- :mk=\\E[8m:cb=\\E[1K:op=\\E[39;49m:Co#8:pa#64:AB=\\E[4%%dm:AF=\\E[3%%dm:cr=^M\
- :bl=^G:do=^J:le=^H:ta=^I:se=\\E[27m:ue=\\E24m\
- :kb=^?:kD=^[[3~:sc=\\E7:rc=\\E8:r1=\\Ec:"
- ;; : -undefine ic
- ;; don't define :te=\\E[2J\\E[?47l\\E8:ti=\\E7\\E[?47h\
- "Termcap capabilities supported.")
- ;; This auxiliary function cranks up the process for term-exec in
- ;; the appropriate environment.
- (defun term-exec-1 (name buffer command switches)
- ;; We need to do an extra (fork-less) exec to run stty.
- ;; (This would not be needed if we had suitable Emacs primitives.)
- ;; The 'if ...; then shift; fi' hack is because Bourne shell
- ;; loses one arg when called with -c, and newer shells (bash, ksh) don't.
- ;; Thus we add an extra dummy argument "..", and then remove it.
- (let ((process-environment
- (nconc
- (list
- (format "TERM=%s" term-term-name)
- (format "TERMINFO=%s" data-directory)
- (format term-termcap-format "TERMCAP="
- term-term-name term-height term-width)
- (format "INSIDE_EMACS=%s,term:%s" emacs-version term-protocol-version)
- (format "LINES=%d" term-height)
- (format "COLUMNS=%d" term-width))
- process-environment))
- (process-connection-type t)
- ;; We should suppress conversion of end-of-line format.
- (inhibit-eol-conversion t)
- ;; The process's output contains not just chars but also binary
- ;; escape codes, so we need to see the raw output. We will have to
- ;; do the decoding by hand on the parts that are made of chars.
- (coding-system-for-read 'binary))
- (apply 'start-process name buffer
- "/bin/sh" "-c"
- (format "stty -nl echo rows %d columns %d sane 2>/dev/null;\
- if [ $1 = .. ]; then shift; fi; exec \"$@\""
- term-height term-width)
- ".."
- command switches)))
- ;;; Input history processing in a buffer
- ;; ===========================================================================
- ;; Useful input history functions, courtesy of the Ergo group.
- ;; Eleven commands:
- ;; term-dynamic-list-input-ring List history in help buffer.
- ;; term-previous-input Previous input...
- ;; term-previous-matching-input ...matching a string.
- ;; term-previous-matching-input-from-input ... matching the current input.
- ;; term-next-input Next input...
- ;; term-next-matching-input ...matching a string.
- ;; term-next-matching-input-from-input ... matching the current input.
- ;; term-backward-matching-input Backwards input...
- ;; term-forward-matching-input ...matching a string.
- ;; term-replace-by-expanded-history Expand history at point;
- ;; replace with expanded history.
- ;; term-magic-space Expand history and insert space.
- ;;
- ;; Three functions:
- ;; term-read-input-ring Read into term-input-ring...
- ;; term-write-input-ring Write to term-input-ring-file-name.
- ;; term-replace-by-expanded-history-before-point Workhorse function.
- (defun term-read-input-ring (&optional silent)
- "Set the buffer's `term-input-ring' from a history file.
- The name of the file is given by the variable `term-input-ring-file-name'.
- The history ring is of size `term-input-ring-size', regardless of file size.
- If `term-input-ring-file-name' is nil this function does nothing.
- If the optional argument SILENT is non-nil, we say nothing about a
- failure to read the history file.
- This function is useful for major mode commands and mode hooks.
- The structure of the history file should be one input command per line,
- with the most recent command last.
- See also `term-input-ignoredups' and `term-write-input-ring'."
- (cond ((or (null term-input-ring-file-name)
- (equal term-input-ring-file-name ""))
- nil)
- ((not (file-readable-p term-input-ring-file-name))
- (or silent
- (message "Cannot read history file %s"
- term-input-ring-file-name)))
- (t
- (let ((file term-input-ring-file-name)
- (count 0)
- (ring (make-ring term-input-ring-size)))
- (with-temp-buffer
- (insert-file-contents file)
- ;; Save restriction in case file is already visited...
- ;; Watch for those date stamps in history files!
- (goto-char (point-max))
- (while (and (< count term-input-ring-size)
- (re-search-backward "^[ \t]*\\([^#\n].*\\)[ \t]*$"
- nil t))
- (let ((history (buffer-substring (match-beginning 1)
- (match-end 1))))
- (when (or (null term-input-ignoredups)
- (ring-empty-p ring)
- (not (string-equal (ring-ref ring 0) history)))
- (ring-insert-at-beginning ring history)))
- (setq count (1+ count))))
- (setq term-input-ring ring
- term-input-ring-index nil)))))
- (defun term-write-input-ring ()
- "Write the buffer's `term-input-ring' to a history file.
- The name of the file is given by the variable `term-input-ring-file-name'.
- The original contents of the file are lost if `term-input-ring' is not empty.
- If `term-input-ring-file-name' is nil this function does nothing.
- Useful within process sentinels.
- See also `term-read-input-ring'."
- (cond ((or (null term-input-ring-file-name)
- (equal term-input-ring-file-name "")
- (null term-input-ring) (ring-empty-p term-input-ring))
- nil)
- ((not (file-writable-p term-input-ring-file-name))
- (message "Cannot write history file %s" term-input-ring-file-name))
- (t
- (let* ((history-buf (get-buffer-create " *Temp Input History*"))
- (ring term-input-ring)
- (file term-input-ring-file-name)
- (index (ring-length ring)))
- ;; Write it all out into a buffer first. Much faster, but messier,
- ;; than writing it one line at a time.
- (with-current-buffer history-buf
- (erase-buffer)
- (while (> index 0)
- (setq index (1- index))
- (insert (ring-ref ring index) ?\n))
- (write-region (buffer-string) nil file nil 'no-message)
- (kill-buffer nil))))))
- (defun term-dynamic-list-input-ring ()
- "List in help buffer the buffer's input history."
- (interactive)
- (if (or (not (ring-p term-input-ring))
- (ring-empty-p term-input-ring))
- (message "No history")
- (let ((history nil)
- (history-buffer " *Input History*")
- (index (1- (ring-length term-input-ring)))
- (conf (current-window-configuration)))
- ;; We have to build up a list ourselves from the ring vector.
- (while (>= index 0)
- (setq history (cons (ring-ref term-input-ring index) history)
- index (1- index)))
- ;; Change "completion" to "history reference"
- ;; to make the display accurate.
- (with-output-to-temp-buffer history-buffer
- (display-completion-list history)
- (set-buffer history-buffer)
- (forward-line 3)
- (while (search-backward "completion" nil 'move)
- (replace-match "history reference")))
- (sit-for 0)
- (message "Hit space to flush")
- (let ((ch (read-event)))
- (if (eq ch ?\s)
- (set-window-configuration conf)
- (push ch unread-command-events))))))
- (defun term-regexp-arg (prompt)
- ;; Return list of regexp and prefix arg using PROMPT.
- (let* (;; Don't clobber this.
- (last-command last-command)
- (regexp (read-from-minibuffer prompt nil nil nil
- 'minibuffer-history-search-history)))
- (list (if (string-equal regexp "")
- (setcar minibuffer-history-search-history
- (nth 1 minibuffer-history-search-history))
- regexp)
- (prefix-numeric-value current-prefix-arg))))
- (defun term-search-arg (arg)
- ;; First make sure there is a ring and that we are after the process mark
- (cond ((not (term-after-pmark-p))
- (error "Not at command line"))
- ((or (null term-input-ring)
- (ring-empty-p term-input-ring))
- (error "Empty input ring"))
- ((zerop arg)
- ;; arg of zero resets search from beginning, and uses arg of 1
- (setq term-input-ring-index nil)
- 1)
- (t
- arg)))
- (defun term-search-start (arg)
- ;; Index to start a directional search, starting at term-input-ring-index
- (if term-input-ring-index
- ;; If a search is running, offset by 1 in direction of arg
- (mod (+ term-input-ring-index (if (> arg 0) 1 -1))
- (ring-length term-input-ring))
- ;; For a new search, start from beginning or end, as appropriate
- (if (>= arg 0)
- 0 ; First elt for forward search
- (1- (ring-length term-input-ring))))) ; Last elt for backward search
- (defun term-previous-input-string (arg)
- "Return the string ARG places along the input ring.
- Moves relative to `term-input-ring-index'."
- (ring-ref term-input-ring (if term-input-ring-index
- (mod (+ arg term-input-ring-index)
- (ring-length term-input-ring))
- arg)))
- (defun term-previous-input (arg)
- "Cycle backwards through input history."
- (interactive "*p")
- (term-previous-matching-input "." arg))
- (defun term-next-input (arg)
- "Cycle forwards through input history."
- (interactive "*p")
- (term-previous-input (- arg)))
- (defun term-previous-matching-input-string (regexp arg)
- "Return the string matching REGEXP ARG places along the input ring.
- Moves relative to `term-input-ring-index'."
- (let* ((pos (term-previous-matching-input-string-position regexp arg)))
- (when pos (ring-ref term-input-ring pos))))
- (defun term-previous-matching-input-string-position
- (regexp arg &optional start)
- "Return the index matching REGEXP ARG places along the input ring.
- Moves relative to START, or `term-input-ring-index'."
- (when (or (not (ring-p term-input-ring))
- (ring-empty-p term-input-ring))
- (error "No history"))
- (let* ((len (ring-length term-input-ring))
- (motion (if (> arg 0) 1 -1))
- (n (mod (- (or start (term-search-start arg)) motion) len))
- (tried-each-ring-item nil)
- (prev nil))
- ;; Do the whole search as many times as the argument says.
- (while (and (/= arg 0) (not tried-each-ring-item))
- ;; Step once.
- (setq prev n
- n (mod (+ n motion) len))
- ;; If we haven't reached a match, step some more.
- (while (and (< n len) (not tried-each-ring-item)
- (not (string-match regexp (ring-ref term-input-ring n))))
- (setq n (mod (+ n motion) len)
- ;; If we have gone all the way around in this search.
- tried-each-ring-item (= n prev)))
- (setq arg (if (> arg 0) (1- arg) (1+ arg))))
- ;; Now that we know which ring element to use, if we found it, return that.
- (when (string-match regexp (ring-ref term-input-ring n))
- n)))
- (defun term-previous-matching-input (regexp n)
- "Search backwards through input history for match for REGEXP.
- \(Previous history elements are earlier commands.)
- With prefix argument N, search for Nth previous match.
- If N is negative, find the next or Nth next match."
- (interactive (term-regexp-arg "Previous input matching (regexp): "))
- (setq n (term-search-arg n))
- (let ((pos (term-previous-matching-input-string-position regexp n)))
- ;; Has a match been found?
- (if (null pos)
- (error "Not found")
- (setq term-input-ring-index pos)
- (message "History item: %d" (1+ pos))
- (delete-region
- ;; Can't use kill-region as it sets this-command
- (process-mark (get-buffer-process (current-buffer))) (point))
- (insert (ring-ref term-input-ring pos)))))
- (defun term-next-matching-input (regexp n)
- "Search forwards through input history for match for REGEXP.
- \(Later history elements are more recent commands.)
- With prefix argument N, search for Nth following match.
- If N is negative, find the previous or Nth previous match."
- (interactive (term-regexp-arg "Next input matching (regexp): "))
- (term-previous-matching-input regexp (- n)))
- (defun term-previous-matching-input-from-input (n)
- "Search backwards through input history for match for current input.
- \(Previous history elements are earlier commands.)
- With prefix argument N, search for Nth previous match.
- If N is negative, search forwards for the -Nth following match."
- (interactive "p")
- (when (not (memq last-command '(term-previous-matching-input-from-input
- term-next-matching-input-from-input)))
- ;; Starting a new search
- (setq term-matching-input-from-input-string
- (buffer-substring
- (process-mark (get-buffer-process (current-buffer)))
- (point))
- term-input-ring-index nil))
- (term-previous-matching-input
- (concat "^" (regexp-quote term-matching-input-from-input-string))
- n))
- (defun term-next-matching-input-from-input (n)
- "Search forwards through input history for match for current input.
- \(Following history elements are more recent commands.)
- With prefix argument N, search for Nth following match.
- If N is negative, search backwards for the -Nth previous match."
- (interactive "p")
- (term-previous-matching-input-from-input (- n)))
- (defun term-replace-by-expanded-history (&optional silent)
- "Expand input command history references before point.
- Expansion is dependent on the value of `term-input-autoexpand'.
- This function depends on the buffer's idea of the input history, which may not
- match the command interpreter's idea, assuming it has one.
- Assumes history syntax is like typical Un*x shells'. However, since Emacs
- cannot know the interpreter's idea of input line numbers, assuming it has one,
- it cannot expand absolute input line number references.
- If the optional argument SILENT is non-nil, never complain
- even if history reference seems erroneous.
- See `term-magic-space' and `term-replace-by-expanded-history-before-point'.
- Returns t if successful."
- (interactive)
- (when (and term-input-autoexpand
- (string-match "[!^]" (funcall term-get-old-input))
- (save-excursion (beginning-of-line)
- (looking-at term-prompt-regexp)))
- ;; Looks like there might be history references in the command.
- (let ((previous-modified-tick (buffer-modified-tick)))
- (message "Expanding history references...")
- (term-replace-by-expanded-history-before-point silent)
- (/= previous-modified-tick (buffer-modified-tick)))))
- (defun term-replace-by-expanded-history-before-point (silent)
- "Expand directory stack reference before point.
- See `term-replace-by-expanded-history'. Returns t if successful."
- (save-excursion
- (let ((toend (- (line-end-position) (point)))
- (start (progn (term-bol nil) (point))))
- (while (progn
- (skip-chars-forward "^!^" (- (line-end-position) toend))
- (< (point) (- (line-end-position) toend)))
- ;; This seems a bit complex. We look for references such as !!, !-num,
- ;; !foo, !?foo, !{bar}, !?{bar}, ^oh, ^my^, ^god^it, ^never^ends^.
- ;; If that wasn't enough, the plings can be suffixed with argument
- ;; range specifiers.
- ;; Argument ranges are complex too, so we hive off the input line,
- ;; referenced with plings, with the range string to `term-args'.
- (setq term-input-ring-index nil)
- (cond ((or (= (preceding-char) ?\\)
- (term-within-quotes start (point)))
- ;; The history is quoted, or we're in quotes.
- (goto-char (1+ (point))))
- ((looking-at "![0-9]+\\($\\|[^-]\\)")
- ;; We cannot know the interpreter's idea of input line numbers.
- (goto-char (match-end 0))
- (message "Absolute reference cannot be expanded"))
- ((looking-at "!-\\([0-9]+\\)\\(:?[0-9^$*-]+\\)?")
- ;; Just a number of args from `number' lines backward.
- (let ((number (1- (string-to-number
- (buffer-substring (match-beginning 1)
- (match-end 1))))))
- (if (<= number (ring-length term-input-ring))
- (progn
- (replace-match
- (term-args (term-previous-input-string number)
- (match-beginning 2) (match-end 2))
- t t)
- (setq term-input-ring-index number)
- (message "History item: %d" (1+ number)))
- (goto-char (match-end 0))
- (message "Relative reference exceeds input history size"))))
- ((or (looking-at "!!?:?\\([0-9^$*-]+\\)") (looking-at "!!"))
- ;; Just a number of args from the previous input line.
- (replace-match
- (term-args (term-previous-input-string 0)
- (match-beginning 1) (match-end 1))
- t t)
- (message "History item: previous"))
- ((looking-at
- "!\\??\\({\\(.+\\)}\\|\\(\\sw+\\)\\)\\(:?[0-9^$*-]+\\)?")
- ;; Most recent input starting with or containing (possibly
- ;; protected) string, maybe just a number of args. Phew.
- (let* ((mb1 (match-beginning 1)) (me1 (match-end 1))
- (mb2 (match-beginning 2)) (me2 (match-end 2))
- (exp (buffer-substring (or mb2 mb1) (or me2 me1)))
- (pref (if (save-match-data (looking-at "!\\?")) "" "^"))
- (pos (save-match-data
- (term-previous-matching-input-string-position
- (concat pref (regexp-quote exp)) 1))))
- (if (null pos)
- (progn
- (goto-char (match-end 0))
- (or silent
- (progn (message "Not found")
- (ding))))
- (setq term-input-ring-index pos)
- (replace-match
- (term-args (ring-ref term-input-ring pos)
- (match-beginning 4) (match-end 4))
- t t)
- (message "History item: %d" (1+ pos)))))
- ((looking-at "\\^\\([^^]+\\)\\^?\\([^^]*\\)\\^?")
- ;; Quick substitution on the previous input line.
- (let ((old (buffer-substring (match-beginning 1) (match-end 1)))
- (new (buffer-substring (match-beginning 2) (match-end 2)))
- (pos nil))
- (replace-match (term-previous-input-string 0) t t)
- (setq pos (point))
- (goto-char (match-beginning 0))
- (if (not (search-forward old pos t))
- (or silent
- (error "Not found"))
- (replace-match new t t)
- (message "History item: substituted"))))
- (t
- (goto-char (match-end 0))))))))
- (defun term-magic-space (arg)
- "Expand input history references before point and insert ARG spaces.
- A useful command to bind to SPC. See `term-replace-by-expanded-history'."
- (interactive "p")
- (term-replace-by-expanded-history)
- (self-insert-command arg))
- (defun term-within-quotes (beg end)
- "Return t if the number of quotes between BEG and END is odd.
- Quotes are single and double."
- (let ((countsq (term-how-many-region "\\(^\\|[^\\\\]\\)'" beg end))
- (countdq (term-how-many-region "\\(^\\|[^\\\\]\\)\"" beg end)))
- (or (= (mod countsq 2) 1) (= (mod countdq 2) 1))))
- (defun term-how-many-region (regexp beg end)
- "Return number of matches for REGEXP from BEG to END."
- (let ((count 0))
- (save-excursion
- (save-match-data
- (goto-char beg)
- (while (re-search-forward regexp end t)
- (setq count (1+ count)))))
- count))
- (defun term-args (string begin end)
- ;; From STRING, return the args depending on the range specified in the text
- ;; from BEGIN to END. If BEGIN is nil, assume all args. Ignore leading `:'.
- ;; Range can be x-y, x-, -y, where x/y can be [0-9], *, ^, $.
- (save-match-data
- (if (null begin)
- (term-arguments string 0 nil)
- (let* ((range (buffer-substring
- (if (eq (char-after begin) ?:) (1+ begin) begin) end))
- (nth (cond ((string-match "^[*^]" range) 1)
- ((string-match "^-" range) 0)
- ((string-equal range "$") nil)
- (t (string-to-number range))))
- (mth (cond ((string-match "[-*$]$" range) nil)
- ((string-match "-" range)
- (string-to-number (substring range (match-end 0))))
- (t nth))))
- (term-arguments string nth mth)))))
- ;; Return a list of arguments from ARG. Break it up at the
- ;; delimiters in term-delimiter-argument-list. Returned list is backwards.
- (defun term-delim-arg (arg)
- (if (null term-delimiter-argument-list)
- (list arg)
- (let ((args nil)
- (pos 0)
- (len (length arg)))
- (while (< pos len)
- (let ((char (aref arg pos))
- (start pos))
- (if (memq char term-delimiter-argument-list)
- (while (and (< pos len) (eq (aref arg pos) char))
- (setq pos (1+ pos)))
- (while (and (< pos len)
- (not (memq (aref arg pos)
- term-delimiter-argument-list)))
- (setq pos (1+ pos))))
- (setq args (cons (substring arg start pos) args))))
- args)))
- (defun term-arguments (string nth mth)
- "Return from STRING the NTH to MTH arguments.
- NTH and/or MTH can be nil, which means the last argument.
- Returned arguments are separated by single spaces.
- We assume whitespace separates arguments, except within quotes.
- Also, a run of one or more of a single character
- in `term-delimiter-argument-list' is a separate argument.
- Argument 0 is the command name."
- (let ((argpart "[^ \n\t\"'`]+\\|\\(\"[^\"]*\"\\|'[^']*'\\|`[^`]*`\\)")
- (args ()) (pos 0)
- (count 0)
- beg str quotes)
- ;; Build a list of all the args until we have as many as we want.
- (while (and (or (null mth) (<= count mth))
- (string-match argpart string pos))
- (if (and beg (= pos (match-beginning 0)))
- ;; It's contiguous, part of the same arg.
- (setq pos (match-end 0)
- quotes (or quotes (match-beginning 1)))
- ;; It's a new separate arg.
- (if beg
- ;; Put the previous arg, if there was one, onto ARGS.
- (setq str (substring string beg pos)
- args (if quotes (cons str args)
- (nconc (term-delim-arg str) args))
- count (1+ count)))
- (setq quotes (match-beginning 1))
- (setq beg (match-beginning 0))
- (setq pos (match-end 0))))
- (if beg
- (setq str (substring string beg pos)
- args (if quotes (cons str args)
- (nconc (term-delim-arg str) args))
- count (1+ count)))
- (let ((n (or nth (1- count)))
- (m (if mth (1- (- count mth)) 0)))
- (mapconcat
- (function (lambda (a) a)) (nthcdr n (nreverse (nthcdr m args))) " "))))
- ;;;
- ;;; Input processing stuff [line mode]
- ;;;
- (defun term-send-input ()
- "Send input to process.
- After the process output mark, sends all text from the process mark to
- point as input to the process. Before the process output mark, calls value
- of variable `term-get-old-input' to retrieve old input, copies it to the
- process mark, and sends it. A terminal newline is also inserted into the
- buffer and sent to the process. The list of function names contained in the
- value of `term-input-filter-functions' is called on the input before sending
- it. The input is entered into the input history ring, if the value of variable
- `term-input-filter' returns non-nil when called on the input.
- Any history reference may be expanded depending on the value of the variable
- `term-input-autoexpand'. The list of function names contained in the value
- of `term-input-filter-functions' is called on the input before sending it.
- The input is entered into the input history ring, if the value of variable
- `term-input-filter' returns non-nil when called on the input.
- If variable `term-eol-on-send' is non-nil, then point is moved to the
- end of line before sending the input.
- The values of `term-get-old-input', `term-input-filter-functions', and
- `term-input-filter' are chosen according to the command interpreter running
- in the buffer. E.g.,
- If the interpreter is the csh,
- term-get-old-input is the default: take the current line, discard any
- initial string matching regexp term-prompt-regexp.
- term-input-filter-functions monitors input for \"cd\", \"pushd\", and
- \"popd\" commands. When it sees one, it cd's the buffer.
- term-input-filter is the default: returns t if the input isn't all white
- space.
- If the term is Lucid Common Lisp,
- term-get-old-input snarfs the sexp ending at point.
- term-input-filter-functions does nothing.
- term-input-filter returns nil if the input matches input-filter-regexp,
- which matches (1) all whitespace (2) :a, :c, etc.
- Similarly for Soar, Scheme, etc."
- (interactive)
- ;; Note that the input string does not include its terminal newline.
- (let ((proc (get-buffer-process (current-buffer))))
- (if (not proc) (error "Current buffer has no process")
- (let* ((pmark (process-mark proc))
- (pmark-val (marker-position pmark))
- (input-is-new (>= (point) pmark-val))
- (intxt (if input-is-new
- (progn (if term-eol-on-send (end-of-line))
- (buffer-substring pmark (point)))
- (funcall term-get-old-input)))
- (input (if (not (eq term-input-autoexpand 'input))
- ;; Just whatever's already there
- intxt
- ;; Expand and leave it visible in buffer
- (term-replace-by-expanded-history t)
- (buffer-substring pmark (point))))
- (history (if (not (eq term-input-autoexpand 'history))
- input
- ;; This is messy 'cos ultimately the original
- ;; functions used do insertion, rather than return
- ;; strings. We have to expand, then insert back.
- (term-replace-by-expanded-history t)
- (let ((copy (buffer-substring pmark (point))))
- (delete-region pmark (point))
- (insert input)
- copy))))
- (when (term-pager-enabled)
- (save-excursion
- (goto-char (process-mark proc))
- (setq term-pager-count (term-current-row))))
- (when (and (funcall term-input-filter history)
- (or (null term-input-ignoredups)
- (not (ring-p term-input-ring))
- (ring-empty-p term-input-ring)
- (not (string-equal (ring-ref term-input-ring 0)
- history))))
- (ring-insert term-input-ring history))
- (let ((functions term-input-filter-functions))
- (while functions
- (funcall (car functions) (concat input "\n"))
- (setq functions (cdr functions))))
- (setq term-input-ring-index nil)
- ;; Update the markers before we send the input
- ;; in case we get output amidst sending the input.
- (set-marker term-last-input-start pmark)
- (set-marker term-last-input-end (point))
- (when input-is-new
- ;; Set up to delete, because inferior should echo.
- (when (marker-buffer term-pending-delete-marker)
- (delete-region term-pending-delete-marker pmark))
- (set-marker term-pending-delete-marker pmark-val)
- (set-marker (process-mark proc) (point)))
- (goto-char pmark)
- (funcall term-input-sender proc input)))))
- (defun term-get-old-input-default ()
- "Default for `term-get-old-input'.
- Take the current line, and discard any initial text matching
- `term-prompt-regexp'."
- (save-excursion
- (beginning-of-line)
- (term-skip-prompt)
- (let ((beg (point)))
- (end-of-line)
- (buffer-substring beg (point)))))
- (defun term-copy-old-input ()
- "Insert after prompt old input at point as new input to be edited.
- Calls `term-get-old-input' to get old input."
- (interactive)
- (let ((input (funcall term-get-old-input))
- (process (get-buffer-process (current-buffer))))
- (if (not process)
- (error "Current buffer has no process")
- (goto-char (process-mark process))
- (insert input))))
- (defun term-skip-prompt ()
- "Skip past the text matching regexp `term-prompt-regexp'.
- If this takes us past the end of the current line, don't skip at all."
- (let ((eol (line-end-position)))
- (when (and (looking-at term-prompt-regexp)
- (<= (match-end 0) eol))
- (goto-char (match-end 0)))))
- (defun term-after-pmark-p ()
- "Is point after the process output marker?"
- ;; Since output could come into the buffer after we looked at the point
- ;; but before we looked at the process marker's value, we explicitly
- ;; serialize. This is just because I don't know whether or not Emacs
- ;; services input during execution of lisp commands.
- (let ((proc-pos (marker-position
- (process-mark (get-buffer-process (current-buffer))))))
- (<= proc-pos (point))))
- (defun term-simple-send (proc string)
- "Default function for sending to PROC input STRING.
- This just sends STRING plus a newline. To override this,
- set the hook `term-input-sender'."
- (term-send-string proc string)
- (term-send-string proc "\n"))
- (defun term-bol (arg)
- "Go to the beginning of line, then skip past the prompt, if any.
- If a prefix argument is given (\\[universal-argument]), then no prompt skip
- -- go straight to column 0.
- The prompt skip is done by skipping text matching the regular expression
- `term-prompt-regexp', a buffer local variable."
- (interactive "P")
- (beginning-of-line)
- (when (null arg) (term-skip-prompt)))
- ;; These two functions are for entering text you don't want echoed or
- ;; saved -- typically passwords to ftp, telnet, or somesuch.
- ;; Just enter m-x term-send-invisible and type in your line.
- (defun term-read-noecho (prompt &optional stars)
- "Read a single line of text from user without echoing, and return it.
- Prompt with argument PROMPT, a string. Optional argument STARS causes
- input to be echoed with '*' characters on the prompt line. Input ends with
- RET, LFD, or ESC. DEL or C-h rubs out. C-u kills line. C-g aborts (if
- `inhibit-quit' is set because e.g. this function was called from a process
- filter and C-g is pressed, this function returns nil rather than a string).
- Note that the keystrokes comprising the text can still be recovered
- \(temporarily) with \\[view-lossage]. This may be a security bug for some
- applications."
- (let ((ans "")
- (c 0)
- (echo-keystrokes 0)
- (cursor-in-echo-area t)
- (done nil))
- (while (not done)
- (if stars
- (message "%s%s" prompt (make-string (length ans) ?*))
- (message "%s" prompt))
- (setq c (read-char))
- (cond ((= c ?\C-g)
- ;; This function may get called from a process filter, where
- ;; inhibit-quit is set. In later versions of Emacs read-char
- ;; may clear quit-flag itself and return C-g. That would make
- ;; it impossible to quit this loop in a simple way, so
- ;; re-enable it here (for backward-compatibility the check for
- ;; quit-flag below would still be necessary, so this seems
- ;; like the simplest way to do things).
- (setq quit-flag t
- done t))
- ((or (= c ?\r) (= c ?\n) (= c ?\e))
- (setq done t))
- ((= c ?\C-u)
- (setq ans ""))
- ((and (/= c ?\b) (/= c ?\177))
- (setq ans (concat ans (char-to-string c))))
- ((> (length ans) 0)
- (setq ans (substring ans 0 -1)))))
- (if quit-flag
- ;; Emulate a true quit, except that we have to return a value.
- (prog1
- (setq quit-flag nil)
- (message "Quit")
- (beep t))
- (message "")
- ans)))
- (defun term-send-invisible (str &optional proc)
- "Read a string without echoing.
- Then send it to the process running in the current buffer. A new-line
- is additionally sent. String is not saved on term input history list.
- Security bug: your string can still be temporarily recovered with
- \\[view-lossage]."
- (interactive "P") ; Defeat snooping via C-x esc
- (when (not (stringp str))
- (setq str (term-read-noecho "Non-echoed text: " t)))
- (when (not proc)
- (setq proc (get-buffer-process (current-buffer))))
- (if (not proc) (error "Current buffer has no process")
- (setq term-kill-echo-list (nconc term-kill-echo-list
- (cons str nil)))
- (term-send-string proc str)
- (term-send-string proc "\n")))
- ;;; Low-level process communication
- (defcustom term-input-chunk-size 512
- "Long inputs send to term processes are broken up into chunks of this size.
- If your process is choking on big inputs, try lowering the value."
- :group 'term
- :type 'integer)
- (defun term-send-string (proc str)
- "Send to PROC the contents of STR as input.
- This is equivalent to `process-send-string', except that long input strings
- are broken up into chunks of size `term-input-chunk-size'. Processes
- are given a chance to output between chunks. This can help prevent processes
- from hanging when you send them long inputs on some OS's."
- (let* ((len (length str))
- (i (min len term-input-chunk-size)))
- (process-send-string proc (substring str 0 i))
- (while (< i len)
- (let ((next-i (+ i term-input-chunk-size)))
- (accept-process-output)
- (process-send-string proc (substring str i (min len next-i)))
- (setq i next-i)))))
- (defun term-send-region (proc start end)
- "Send to PROC the region delimited by START and END.
- This is a replacement for `process-send-region' that tries to keep
- your process from hanging on long inputs. See `term-send-string'."
- (term-send-string proc (buffer-substring start end)))
- ;;; Random input hackage
- (defun term-kill-output ()
- "Kill all output from interpreter since last input."
- (interactive)
- (let ((pmark (process-mark (get-buffer-process (current-buffer)))))
- (kill-region term-last-input-end pmark)
- (goto-char pmark)
- (insert "*** output flushed ***\n")
- (set-marker pmark (point))))
- (defun term-show-output ()
- "Display start of this batch of interpreter output at top of window.
- Sets mark to the value of point when this command is run."
- (interactive)
- (goto-char term-last-input-end)
- (backward-char)
- (beginning-of-line)
- (set-window-start (selected-window) (point))
- (end-of-line))
- (defun term-interrupt-subjob ()
- "Interrupt the current subjob."
- (interactive)
- (interrupt-process nil term-ptyp))
- (defun term-kill-subjob ()
- "Send kill signal to the current subjob."
- (interactive)
- (kill-process nil term-ptyp))
- (defun term-quit-subjob ()
- "Send quit signal to the current subjob."
- (interactive)
- (quit-process nil term-ptyp))
- (defun term-stop-subjob ()
- "Stop the current subjob.
- WARNING: if there is no current subjob, you can end up suspending
- the top-level process running in the buffer. If you accidentally do
- this, use \\[term-continue-subjob] to resume the process. (This
- is not a problem with most shells, since they ignore this signal.)"
- (interactive)
- (stop-process nil term-ptyp))
- (defun term-continue-subjob ()
- "Send CONT signal to process buffer's process group.
- Useful if you accidentally suspend the top-level process."
- (interactive)
- (continue-process nil term-ptyp))
- (defun term-kill-input ()
- "Kill all text from last stuff output by interpreter to point."
- (interactive)
- (let* ((pmark (process-mark (get-buffer-process (current-buffer))))
- (p-pos (marker-position pmark)))
- (when (> (point) p-pos)
- (kill-region pmark (point)))))
- (defun term-delchar-or-maybe-eof (arg)
- "Delete ARG characters forward, or send an EOF to process if at end of
- buffer."
- (interactive "p")
- (if (eobp)
- (process-send-eof)
- (delete-char arg)))
- (defun term-send-eof ()
- "Send an EOF to the current buffer's process."
- (interactive)
- (process-send-eof))
- (defun term-backward-matching-input (regexp n)
- "Search backward through buffer for match for REGEXP.
- Matches are searched for on lines that match `term-prompt-regexp'.
- With prefix argument N, search for Nth previous match.
- If N is negative, find the next or Nth next match."
- (interactive (term-regexp-arg "Backward input matching (regexp): "))
- (let* ((re (concat term-prompt-regexp ".*" regexp))
- (pos (save-excursion (end-of-line (if (> n 0) 0 1))
- (when (re-search-backward re nil t n)
- (point)))))
- (if (null pos)
- (progn (message "Not found")
- (ding))
- (goto-char pos)
- (term-bol nil))))
- (defun term-forward-matching-input (regexp n)
- "Search forward through buffer for match for REGEXP.
- Matches are searched for on lines that match `term-prompt-regexp'.
- With prefix argument N, search for Nth following match.
- If N is negative, find the previous or Nth previous match."
- (interactive (term-regexp-arg "Forward input matching (regexp): "))
- (term-backward-matching-input regexp (- n)))
- (defun term-next-prompt (n)
- "Move to end of Nth next prompt in the buffer.
- See `term-prompt-regexp'."
- (interactive "p")
- (let ((paragraph-start term-prompt-regexp))
- (end-of-line (if (> n 0) 1 0))
- (forward-paragraph n)
- (term-skip-prompt)))
- (defun term-previous-prompt (n)
- "Move to end of Nth previous prompt in the buffer.
- See `term-prompt-regexp'."
- (interactive "p")
- (term-next-prompt (- n)))
- ;;; Support for source-file processing commands.
- ;;============================================================================
- ;; Many command-interpreters (e.g., Lisp, Scheme, Soar) have
- ;; commands that process files of source text (e.g. loading or compiling
- ;; files). So the corresponding process-in-a-buffer modes have commands
- ;; for doing this (e.g., lisp-load-file). The functions below are useful
- ;; for defining these commands.
- ;;
- ;; Alas, these guys don't do exactly the right thing for Lisp, Scheme
- ;; and Soar, in that they don't know anything about file extensions.
- ;; So the compile/load interface gets the wrong default occasionally.
- ;; The load-file/compile-file default mechanism could be smarter -- it
- ;; doesn't know about the relationship between filename extensions and
- ;; whether the file is source or executable. If you compile foo.lisp
- ;; with compile-file, then the next load-file should use foo.bin for
- ;; the default, not foo.lisp. This is tricky to do right, particularly
- ;; because the extension for executable files varies so much (.o, .bin,
- ;; .lbin, .mo, .vo, .ao, ...).
- ;; TERM-SOURCE-DEFAULT -- determines defaults for source-file processing
- ;; commands.
- ;;
- ;; TERM-CHECK-SOURCE -- if FNAME is in a modified buffer, asks you if you
- ;; want to save the buffer before issuing any process requests to the command
- ;; interpreter.
- ;;
- ;; TERM-GET-SOURCE -- used by the source-file processing commands to prompt
- ;; for the file to process.
- ;; (TERM-SOURCE-DEFAULT previous-dir/file source-modes)
- ;;============================================================================
- ;; This function computes the defaults for the load-file and compile-file
- ;; commands for tea, soar, cmulisp, and cmuscheme modes.
- ;;
- ;; - PREVIOUS-DIR/FILE is a pair (directory . filename) from the last
- ;; source-file processing command, or nil if there hasn't been one yet.
- ;; - SOURCE-MODES is a list used to determine what buffers contain source
- ;; files: if the major mode of the buffer is in SOURCE-MODES, it's source.
- ;; Typically, (lisp-mode) or (scheme-mode).
- ;;
- ;; If the command is given while the cursor is inside a string, *and*
- ;; the string is an existing filename, *and* the filename is not a directory,
- ;; then the string is taken as default. This allows you to just position
- ;; your cursor over a string that's a filename and have it taken as default.
- ;;
- ;; If the command is given in a file buffer whose major mode is in
- ;; SOURCE-MODES, then the filename is the default file, and the
- ;; file's directory is the default directory.
- ;;
- ;; If the buffer isn't a source file buffer (e.g., it's the process buffer),
- ;; then the default directory & file are what was used in the last source-file
- ;; processing command (i.e., PREVIOUS-DIR/FILE). If this is the first time
- ;; the command has been run (PREVIOUS-DIR/FILE is nil), the default directory
- ;; is the cwd, with no default file. (\"no default file\" = nil)
- ;;
- ;; SOURCE-REGEXP is typically going to be something like (tea-mode)
- ;; for T programs, (lisp-mode) for Lisp programs, (soar-mode lisp-mode)
- ;; for Soar programs, etc.
- ;;
- ;; The function returns a pair: (default-directory . default-file).
- (defun term-source-default (previous-dir/file source-modes)
- (cond ((and buffer-file-name (memq major-mode source-modes))
- (cons (file-name-directory buffer-file-name)
- (file-name-nondirectory buffer-file-name)))
- (previous-dir/file)
- (t
- (cons default-directory nil))))
- ;; (TERM-CHECK-SOURCE fname)
- ;;============================================================================
- ;; Prior to loading or compiling (or otherwise processing) a file (in the CMU
- ;; process-in-a-buffer modes), this function can be called on the filename.
- ;; If the file is loaded into a buffer, and the buffer is modified, the user
- ;; is queried to see if he wants to save the buffer before proceeding with
- ;; the load or compile.
- (defun term-check-source (fname)
- (let ((buff (get-file-buffer fname)))
- (when (and buff
- (buffer-modified-p buff)
- (y-or-n-p (format "Save buffer %s first? "
- (buffer-name buff))))
- ;; save BUFF.
- (with-current-buffer buff
- (save-buffer)))))
- ;; (TERM-GET-SOURCE prompt prev-dir/file source-modes mustmatch-p)
- ;;============================================================================
- ;; TERM-GET-SOURCE is used to prompt for filenames in command-interpreter
- ;; commands that process source files (like loading or compiling a file).
- ;; It prompts for the filename, provides a default, if there is one,
- ;; and returns the result filename.
- ;;
- ;; See TERM-SOURCE-DEFAULT for more on determining defaults.
- ;;
- ;; PROMPT is the prompt string. PREV-DIR/FILE is the (directory . file) pair
- ;; from the last source processing command. SOURCE-MODES is a list of major
- ;; modes used to determine what file buffers contain source files. (These
- ;; two arguments are used for determining defaults). If MUSTMATCH-P is true,
- ;; then the filename reader will only accept a file that exists.
- ;;
- ;; A typical use:
- ;; (interactive (term-get-source "Compile file: " prev-lisp-dir/file
- ;; '(lisp-mode) t))
- ;; This is pretty stupid about strings. It decides we're in a string
- ;; if there's a quote on both sides of point on the current line.
- (defun term-extract-string ()
- "Return string around `point' that starts the current line or nil."
- (save-excursion
- (let* ((point (point))
- (bol (line-beginning-position))
- (eol (line-end-position))
- (start (and (search-backward "\"" bol t)
- (1+ (point))))
- (end (progn (goto-char point)
- (and (search-forward "\"" eol t)
- (1- (point))))))
- (and start end
- (buffer-substring start end)))))
- (defun term-get-source (prompt prev-dir/file source-modes mustmatch-p)
- (let* ((def (term-source-default prev-dir/file source-modes))
- (stringfile (term-extract-string))
- (sfile-p (and stringfile
- (condition-case ()
- (file-exists-p stringfile)
- (error nil))
- (not (file-directory-p stringfile))))
- (defdir (if sfile-p (file-name-directory stringfile)
- (car def)))
- (deffile (if sfile-p (file-name-nondirectory stringfile)
- (cdr def)))
- (ans (read-file-name (if deffile (format "%s(default %s) "
- prompt deffile)
- prompt)
- defdir
- (concat defdir deffile)
- mustmatch-p)))
- (list (expand-file-name (substitute-in-file-name ans)))))
- ;; I am somewhat divided on this string-default feature. It seems
- ;; to violate the principle-of-least-astonishment, in that it makes
- ;; the default harder to predict, so you actually have to look and see
- ;; what the default really is before choosing it. This can trip you up.
- ;; On the other hand, it can be useful, I guess. I would appreciate feedback
- ;; on this.
- ;; -Olin
- ;;; Simple process query facility.
- ;; ===========================================================================
- ;; This function is for commands that want to send a query to the process
- ;; and show the response to the user. For example, a command to get the
- ;; arglist for a Common Lisp function might send a "(arglist 'foo)" query
- ;; to an inferior Common Lisp process.
- ;;
- ;; This simple facility just sends strings to the inferior process and pops
- ;; up a window for the process buffer so you can see what the process
- ;; responds with. We don't do anything fancy like try to intercept what the
- ;; process responds with and put it in a pop-up window or on the message
- ;; line. We just display the buffer. Low tech. Simple. Works good.
- ;; Send to the inferior process PROC the string STR. Pop-up but do not select
- ;; a window for the inferior process so that its response can be seen.
- (defun term-proc-query (proc str)
- (let* ((proc-buf (process-buffer proc))
- (proc-mark (process-mark proc)))
- (display-buffer proc-buf)
- (set-buffer proc-buf) ; but it's not the selected *window*
- (let ((proc-win (get-buffer-window proc-buf))
- (proc-pt (marker-position proc-mark)))
- (term-send-string proc str) ; send the query
- (accept-process-output proc) ; wait for some output
- ;; Try to position the proc window so you can see the answer.
- ;; This is bogus code. If you delete the (sit-for 0), it breaks.
- ;; I don't know why. Wizards invited to improve it.
- (when (not (pos-visible-in-window-p proc-pt proc-win))
- (let ((opoint (window-point proc-win)))
- (set-window-point proc-win proc-mark) (sit-for 0)
- (if (not (pos-visible-in-window-p opoint proc-win))
- (push-mark opoint)
- (set-window-point proc-win opoint)))))))
- ;; Returns the current column in the current screen line.
- ;; Note: (current-column) yields column in buffer line.
- (defun term-horizontal-column ()
- (- (term-current-column) (term-start-line-column)))
- ;; Calls either vertical-motion or term-buffer-vertical-motion
- (defmacro term-vertical-motion (count)
- (list 'funcall 'term-vertical-motion count))
- ; An emulation of vertical-motion that is independent of having a window.
- ; Instead, it uses the term-width variable as the logical window width.
- (defun term-buffer-vertical-motion (count)
- (cond ((= count 0)
- (move-to-column (* term-width (/ (current-column) term-width)))
- 0)
- ((> count 0)
- (let ((H)
- (todo (+ count (/ (current-column) term-width))))
- (end-of-line)
- ;; The loop iterates over buffer lines;
- ;; H is the number of screen lines in the current line, i.e.
- ;; the ceiling of dividing the buffer line width by term-width.
- (while (and (<= (setq H (max (/ (+ (current-column) term-width -1)
- term-width)
- 1))
- todo)
- (not (eobp)))
- (setq todo (- todo H))
- (forward-char) ;; Move past the ?\n
- (end-of-line)) ;; and on to the end of the next line.
- (if (and (>= todo H) (> todo 0))
- (+ (- count todo) H -1) ;; Hit end of buffer.
- (move-to-column (* todo term-width))
- count)))
- (t ;; (< count 0) ;; Similar algorithm, but for upward motion.
- (let ((H)
- (todo (- count)))
- (while (and (<= (setq H (max (/ (+ (current-column) term-width -1)
- term-width)
- 1))
- todo)
- (progn (beginning-of-line)
- (not (bobp))))
- (setq todo (- todo H))
- (backward-char)) ;; Move to end of previous line.
- (if (and (>= todo H) (> todo 0))
- (+ count todo (- 1 H)) ;; Hit beginning of buffer.
- (move-to-column (* (- H todo 1) term-width))
- count)))))
- ;; The term-start-line-column variable is used as a cache.
- (defun term-start-line-column ()
- (cond (term-start-line-column)
- ((let ((save-pos (point)))
- (term-vertical-motion 0)
- (setq term-start-line-column (current-column))
- (goto-char save-pos)
- term-start-line-column))))
- ;; Same as (current-column), but uses term-current-column as a cache.
- (defun term-current-column ()
- (cond (term-current-column)
- ((setq term-current-column (current-column)))))
- ;; Move DELTA column right (or left if delta < 0 limiting at column 0).
- (defun term-move-columns (delta)
- (setq term-current-column (max 0 (+ (term-current-column) delta)))
- (let ((point-at-eol (line-end-position)))
- (move-to-column term-current-column t)
- ;; If move-to-column extends the current line it will use the face
- ;; from the last character on the line, set the face for the chars
- ;; to default.
- (when (> (point) point-at-eol)
- (put-text-property point-at-eol (point) 'font-lock-face 'default))))
- ;; Insert COUNT copies of CHAR in the default face.
- (defun term-insert-char (char count)
- (let ((old-point (point)))
- (insert-char char count)
- (put-text-property old-point (point) 'font-lock-face 'default)))
- (defun term-current-row ()
- (cond (term-current-row)
- ((setq term-current-row
- (save-restriction
- (save-excursion
- (narrow-to-region term-home-marker (point-max))
- (- (term-vertical-motion -9999))))))))
- (defun term-adjust-current-row-cache (delta)
- (when term-current-row
- (setq term-current-row
- (max 0 (+ term-current-row delta)))))
- (defun term-terminal-pos ()
- (save-excursion ; save-restriction
- (let ((save-col (term-current-column))
- x y)
- (term-vertical-motion 0)
- (setq x (- save-col (current-column)))
- (setq y (term-vertical-motion term-height))
- (cons x y))))
- ;;Function that handles term messages: code by rms (and you can see the
- ;;difference ;-) -mm
- (defun term-handle-ansi-terminal-messages (message)
- ;; Is there a command here?
- (while (string-match "\eAnSiT.+\n" message)
- ;; Extract the command code and the argument.
- (let* ((start (match-beginning 0))
- (command-code (aref message (+ start 6)))
- (argument
- (save-match-data
- (substring message
- (+ start 8)
- (string-match "\r?\n" message
- (+ start 8)))))
- ignore)
- ;; Delete this command from MESSAGE.
- (setq message (replace-match "" t t message))
- ;; If we recognize the type of command, set the appropriate variable.
- (cond ((= command-code ?c)
- (setq term-ansi-at-dir argument))
- ((= command-code ?h)
- (setq term-ansi-at-host argument))
- ((= command-code ?u)
- (setq term-ansi-at-user argument))
- ;; Otherwise ignore this one.
- (t
- (setq ignore t)))
- ;; Update default-directory based on the changes this command made.
- (if ignore
- nil
- (setq default-directory
- (file-name-as-directory
- (if (and (string= term-ansi-at-host (system-name))
- (string= term-ansi-at-user (user-real-login-name)))
- (expand-file-name term-ansi-at-dir)
- (if (string= term-ansi-at-user (user-real-login-name))
- (concat "/" term-ansi-at-host ":" term-ansi-at-dir)
- (concat "/" term-ansi-at-user "@" term-ansi-at-host ":"
- term-ansi-at-dir)))))
- ;; I'm not sure this is necessary,
- ;; but it's best to be on the safe side.
- (if (string= term-ansi-at-host (system-name))
- (progn
- (setq ange-ftp-default-user term-ansi-at-save-user)
- (setq ange-ftp-default-password term-ansi-at-save-pwd)
- (setq ange-ftp-generate-anonymous-password term-ansi-at-save-anon))
- (setq term-ansi-at-save-user ange-ftp-default-user)
- (setq term-ansi-at-save-pwd ange-ftp-default-password)
- (setq term-ansi-at-save-anon ange-ftp-generate-anonymous-password)
- (setq ange-ftp-default-user nil)
- (setq ange-ftp-default-password nil)
- (setq ange-ftp-generate-anonymous-password nil)))))
- message)
- ;; Terminal emulation
- ;; This is the standard process filter for term buffers.
- ;; It emulates (most of the features of) a VT100/ANSI-style terminal.
- (defun term-emulate-terminal (proc str)
- (with-current-buffer (process-buffer proc)
- (let* ((i 0) char funny
- count ; number of decoded chars in substring
- count-bytes ; number of bytes
- decoded-substring
- save-point save-marker old-point temp win
- (buffer-undo-list t)
- (selected (selected-window))
- last-win
- handled-ansi-message
- (str-length (length str)))
- (save-selected-window
- (let ((newstr (term-handle-ansi-terminal-messages str)))
- (unless (eq str newstr)
- (setq handled-ansi-message t
- str newstr)))
- (setq str-length (length str))
- (when (marker-buffer term-pending-delete-marker)
- ;; Delete text following term-pending-delete-marker.
- (delete-region term-pending-delete-marker (process-mark proc))
- (set-marker term-pending-delete-marker nil))
- (when (/= (point) (process-mark proc))
- (setq save-point (point-marker)))
- (setf term-vertical-motion
- (if (eq (window-buffer) (current-buffer))
- 'vertical-motion
- 'term-buffer-vertical-motion))
- (setq save-marker (copy-marker (process-mark proc)))
- (goto-char (process-mark proc))
- (save-restriction
- ;; If the buffer is in line mode, and there is a partial
- ;; input line, save the line (by narrowing to leave it
- ;; outside the restriction ) until we're done with output.
- (when (and (> (point-max) (process-mark proc))
- (term-in-line-mode))
- (narrow-to-region (point-min) (process-mark proc)))
- (when term-log-buffer
- (princ str term-log-buffer))
- (cond ((eq term-terminal-state 4) ;; Have saved pending output.
- (setq str (concat term-terminal-parameter str))
- (setq term-terminal-parameter nil)
- (setq str-length (length str))
- (setq term-terminal-state 0)))
- (while (< i str-length)
- (setq char (aref str i))
- (cond ((< term-terminal-state 2)
- ;; Look for prefix of regular chars
- (setq funny
- (string-match "[\r\n\000\007\033\t\b\032\016\017]"
- str i))
- (when (not funny) (setq funny str-length))
- (cond ((> funny i)
- ;; Decode the string before counting
- ;; characters, to avoid garbling of certain
- ;; multibyte characters (bug#1006).
- (setq decoded-substring
- (decode-coding-string
- (substring str i funny)
- locale-coding-system))
- (cond ((eq term-terminal-state 1)
- ;; We are in state 1, we need to wrap
- ;; around. Go to the beginning of
- ;; the next line and switch to state
- ;; 0.
- (term-down 1 t)
- (term-move-columns (- (term-current-column)))
- (setq term-terminal-state 0)))
- (setq count (length decoded-substring))
- (setq temp (- (+ (term-horizontal-column) count)
- term-width))
- (cond ((or term-suppress-hard-newline (<= temp 0)))
- ;; All count chars fit in line.
- ((> count temp) ;; Some chars fit.
- ;; This iteration, handle only what fits.
- (setq count (- count temp))
- (setq count-bytes
- (length
- (encode-coding-string
- (substring decoded-substring 0 count)
- 'binary)))
- (setq temp 0)
- (setq funny (+ count-bytes i)))
- ((or (not (or term-pager-count
- term-scroll-with-delete))
- (> (term-handle-scroll 1) 0))
- (term-adjust-current-row-cache 1)
- (setq count (min count term-width))
- (setq count-bytes
- (length
- (encode-coding-string
- (substring decoded-substring 0 count)
- 'binary)))
- (setq funny (+ count-bytes i))
- (setq term-start-line-column
- term-current-column))
- (t ;; Doing PAGER processing.
- (setq count 0 funny i)
- (setq term-current-column nil)
- (setq term-start-line-column nil)))
- (setq old-point (point))
- ;; Insert a string, check how many columns
- ;; we moved, then delete that many columns
- ;; following point if not eob nor insert-mode.
- (let ((old-column (current-column))
- columns pos)
- (insert (decode-coding-string (substring str i funny) locale-coding-system))
- (setq term-current-column (current-column)
- columns (- term-current-column old-column))
- (when (not (or (eobp) term-insert-mode))
- (setq pos (point))
- (term-move-columns columns)
- (delete-region pos (point)))
- ;; In insert mode if the current line
- ;; has become too long it needs to be
- ;; chopped off.
- (when term-insert-mode
- (setq pos (point))
- (end-of-line)
- (when (> (current-column) term-width)
- (delete-region (- (point) (- (current-column) term-width))
- (point)))
- (goto-char pos)))
- (setq term-current-column nil)
- (put-text-property old-point (point)
- 'font-lock-face term-current-face)
- ;; If the last char was written in last column,
- ;; back up one column, but remember we did so.
- ;; Thus we emulate xterm/vt100-style line-wrapping.
- (cond ((eq temp 0)
- (term-move-columns -1)
- (setq term-terminal-state 1)))
- (setq i (1- funny)))
- ((and (setq term-terminal-state 0)
- (eq char ?\^I)) ; TAB (terminfo: ht)
- (setq count (term-current-column))
- ;; The line cannot exceed term-width. TAB at
- ;; the end of a line should not cause wrapping.
- (setq count (min term-width
- (+ count 8 (- (mod count 8)))))
- (if (> term-width count)
- (progn
- (term-move-columns
- (- count (term-current-column)))
- (setq term-current-column count))
- (when (> term-width (term-current-column))
- (term-move-columns
- (1- (- term-width (term-current-column)))))
- (when (= term-width (term-current-column))
- (term-move-columns -1))))
- ((eq char ?\r) ;; (terminfo: cr)
- (term-vertical-motion 0)
- (setq term-current-column term-start-line-column))
- ((eq char ?\n) ;; (terminfo: cud1, ind)
- (unless (and term-kill-echo-list
- (term-check-kill-echo-list))
- (term-down 1 t)))
- ((eq char ?\b) ;; (terminfo: cub1)
- (term-move-columns -1))
- ((eq char ?\033) ; Escape
- (setq term-terminal-state 2))
- ((eq char 0)) ; NUL: Do nothing
- ((eq char ?\016)) ; Shift Out - ignored
- ((eq char ?\017)) ; Shift In - ignored
- ((eq char ?\^G) ;; (terminfo: bel)
- (beep t))
- ((and (eq char ?\032)
- (not handled-ansi-message))
- (let ((end (string-match "\r?$" str i)))
- (if end
- (funcall term-command-hook
- (decode-coding-string
- (prog1 (substring str (1+ i) end)
- (setq i (match-end 0)))
- locale-coding-system))
- (setq term-terminal-parameter (substring str i))
- (setq term-terminal-state 4)
- (setq i str-length))))
- (t ; insert char FIXME: Should never happen
- (term-move-columns 1)
- (backward-delete-char 1)
- (insert char))))
- ((eq term-terminal-state 2) ; Seen Esc
- (cond ((eq char ?\133) ;; ?\133 = ?[
- ;; Some modifications to cope with multiple
- ;; settings like ^[[01;32;43m -mm
- ;; Note that now the init value of
- ;; term-terminal-previous-parameter has been
- ;; changed to -1
- (setq term-terminal-parameter 0)
- (setq term-terminal-previous-parameter -1)
- (setq term-terminal-previous-parameter-2 -1)
- (setq term-terminal-previous-parameter-3 -1)
- (setq term-terminal-previous-parameter-4 -1)
- (setq term-terminal-more-parameters 0)
- (setq term-terminal-state 3))
- ((eq char ?D) ;; scroll forward
- (term-handle-deferred-scroll)
- (term-down 1 t)
- (setq term-terminal-state 0))
- ;; ((eq char ?E) ;; (terminfo: nw), not used for
- ;; ;; now, but this is a working
- ;; ;; implementation
- ;; (term-down 1)
- ;; (term-goto term-current-row 0)
- ;; (setq term-terminal-state 0))
- ((eq char ?M) ;; scroll reversed (terminfo: ri)
- (if (or (< (term-current-row) term-scroll-start)
- (>= (1- (term-current-row))
- term-scroll-start))
- ;; Scrolling up will not move outside
- ;; the scroll region.
- (term-down -1)
- ;; Scrolling the scroll region is needed.
- (term-down -1 t))
- (setq term-terminal-state 0))
- ((eq char ?7) ;; Save cursor (terminfo: sc)
- (term-handle-deferred-scroll)
- (setq term-saved-cursor
- (list (term-current-row)
- (term-horizontal-column)
- term-ansi-current-bg-color
- term-ansi-current-bold
- term-ansi-current-color
- term-ansi-current-invisible
- term-ansi-current-reverse
- term-ansi-current-underline
- term-current-face)
- )
- (setq term-terminal-state 0))
- ((eq char ?8) ;; Restore cursor (terminfo: rc)
- (when term-saved-cursor
- (term-goto (nth 0 term-saved-cursor)
- (nth 1 term-saved-cursor))
- (setq term-ansi-current-bg-color
- (nth 2 term-saved-cursor)
- term-ansi-current-bold
- (nth 3 term-saved-cursor)
- term-ansi-current-color
- (nth 4 term-saved-cursor)
- term-ansi-current-invisible
- (nth 5 term-saved-cursor)
- term-ansi-current-reverse
- (nth 6 term-saved-cursor)
- term-ansi-current-underline
- (nth 7 term-saved-cursor)
- term-current-face
- (nth 8 term-saved-cursor)))
- (setq term-terminal-state 0))
- ((eq char ?c) ;; \Ec - Reset (terminfo: rs1)
- ;; This is used by the "clear" program.
- (setq term-terminal-state 0)
- (term-reset-terminal))
- ;; The \E#8 reset sequence for xterm. We
- ;; probably don't need to handle it, but this
- ;; is the code to parse it.
- ;; ((eq char ?#)
- ;; (when (eq (aref str (1+ i)) ?8)
- ;; (setq i (1+ i))
- ;; (setq term-scroll-start 0)
- ;; (setq term-scroll-end term-height)
- ;; (setq term-terminal-state 0)))
- ((setq term-terminal-state 0))))
- ((eq term-terminal-state 3) ; Seen Esc [
- (cond ((and (>= char ?0) (<= char ?9))
- (setq term-terminal-parameter
- (+ (* 10 term-terminal-parameter) (- char ?0))))
- ((eq char ?\;)
- ;; Some modifications to cope with multiple
- ;; settings like ^[[01;32;43m -mm
- (setq term-terminal-more-parameters 1)
- (setq term-terminal-previous-parameter-4
- term-terminal-previous-parameter-3)
- (setq term-terminal-previous-parameter-3
- term-terminal-previous-parameter-2)
- (setq term-terminal-previous-parameter-2
- term-terminal-previous-parameter)
- (setq term-terminal-previous-parameter
- term-terminal-parameter)
- (setq term-terminal-parameter 0))
- ((eq char ??)) ; Ignore ?
- (t
- (term-handle-ansi-escape proc char)
- (setq term-terminal-more-parameters 0)
- (setq term-terminal-previous-parameter-4 -1)
- (setq term-terminal-previous-parameter-3 -1)
- (setq term-terminal-previous-parameter-2 -1)
- (setq term-terminal-previous-parameter -1)
- (setq term-terminal-state 0)))))
- (when (term-handling-pager)
- ;; Finish stuff to get ready to handle PAGER.
- (if (> (% (current-column) term-width) 0)
- (setq term-terminal-parameter
- (substring str i))
- ;; We're at column 0. Goto end of buffer; to compensate,
- ;; prepend a ?\r for later. This looks more consistent.
- (if (zerop i)
- (setq term-terminal-parameter
- (concat "\r" (substring str i)))
- (setq term-terminal-parameter (substring str (1- i)))
- (aset term-terminal-parameter 0 ?\r))
- (goto-char (point-max)))
- (setq term-terminal-state 4)
- (make-local-variable 'term-pager-old-filter)
- (setq term-pager-old-filter (process-filter proc))
- (set-process-filter proc term-pager-filter)
- (setq i str-length))
- (setq i (1+ i))))
- (when (>= (term-current-row) term-height)
- (term-handle-deferred-scroll))
- (set-marker (process-mark proc) (point))
- (when save-point
- (goto-char save-point)
- (set-marker save-point nil))
- ;; Check for a pending filename-and-line number to display.
- ;; We do this before scrolling, because we might create a new window.
- (when (and term-pending-frame
- (eq (window-buffer selected) (current-buffer)))
- (term-display-line (car term-pending-frame)
- (cdr term-pending-frame))
- (setq term-pending-frame nil))
- ;; Scroll each window displaying the buffer but (by default)
- ;; only if the point matches the process-mark we started with.
- (setq win selected)
- ;; Avoid infinite loop in strange case where minibuffer window
- ;; is selected but not active.
- (while (window-minibuffer-p win)
- (setq win (next-window win nil t)))
- (setq last-win win)
- (while (progn
- (setq win (next-window win nil t))
- (when (eq (window-buffer win) (process-buffer proc))
- (let ((scroll term-scroll-to-bottom-on-output))
- (select-window win)
- (when (or (= (point) save-marker)
- (eq scroll t) (eq scroll 'all)
- ;; Maybe user wants point to jump to the end.
- (and (eq selected win)
- (or (eq scroll 'this) (not save-point)))
- (and (eq scroll 'others)
- (not (eq selected win))))
- (goto-char term-home-marker)
- (recenter 0)
- (goto-char (process-mark proc))
- (if (not (pos-visible-in-window-p (point) win))
- (recenter -1)))
- ;; Optionally scroll so that the text
- ;; ends at the bottom of the window.
- (when (and term-scroll-show-maximum-output
- (>= (point) (process-mark proc)))
- (save-excursion
- (goto-char (point-max))
- (recenter -1)))))
- (not (eq win last-win))))
- ;; Stolen from comint.el and adapted -mm
- (when (> term-buffer-maximum-size 0)
- (save-excursion
- (goto-char (process-mark (get-buffer-process (current-buffer))))
- (forward-line (- term-buffer-maximum-size))
- (beginning-of-line)
- (delete-region (point-min) (point))))
- (set-marker save-marker nil)))
- ;; This might be expensive, but we need it to handle something
- ;; like `sleep 5 | less -c' in more-or-less real time.
- (when (get-buffer-window (current-buffer))
- (redisplay))))
- (defun term-handle-deferred-scroll ()
- (let ((count (- (term-current-row) term-height)))
- (when (>= count 0)
- (save-excursion
- (goto-char term-home-marker)
- (term-vertical-motion (1+ count))
- (set-marker term-home-marker (point))
- (setq term-current-row (1- term-height))))))
- (defun term-reset-terminal ()
- "Reset the terminal, delete all the content and set the face to the default one."
- (erase-buffer)
- (term-ansi-reset)
- (setq term-current-row 0)
- (setq term-current-column 1)
- (setq term-scroll-start 0)
- (setq term-scroll-end term-height)
- (setq term-insert-mode nil)
- ;; FIXME: No idea why this is here, it looks wrong. --Stef
- (setq term-ansi-face-already-done nil))
- ;; New function to deal with ansi colorized output, as you can see you can
- ;; have any bold/underline/fg/bg/reverse combination. -mm
- (defun term-handle-colors-array (parameter)
- (cond
- ;; Bold (terminfo: bold)
- ((eq parameter 1)
- (setq term-ansi-current-bold t))
- ;; Underline
- ((eq parameter 4)
- (setq term-ansi-current-underline t))
- ;; Blink (unsupported by Emacs), will be translated to bold.
- ;; This may change in the future though.
- ((eq parameter 5)
- (setq term-ansi-current-bold t))
- ;; Reverse (terminfo: smso)
- ((eq parameter 7)
- (setq term-ansi-current-reverse t))
- ;; Invisible
- ((eq parameter 8)
- (setq term-ansi-current-invisible t))
- ;; Reset underline (terminfo: rmul)
- ((eq parameter 24)
- (setq term-ansi-current-underline nil))
- ;; Reset reverse (terminfo: rmso)
- ((eq parameter 27)
- (setq term-ansi-current-reverse nil))
- ;; Foreground
- ((and (>= parameter 30) (<= parameter 37))
- (setq term-ansi-current-color (- parameter 29)))
- ;; Reset foreground
- ((eq parameter 39)
- (setq term-ansi-current-color 0))
- ;; Background
- ((and (>= parameter 40) (<= parameter 47))
- (setq term-ansi-current-bg-color (- parameter 39)))
- ;; Reset background
- ((eq parameter 49)
- (setq term-ansi-current-bg-color 0))
- ;; 0 (Reset) or unknown (reset anyway)
- (t
- (term-ansi-reset)))
- ;; (message "Debug: U-%d R-%d B-%d I-%d D-%d F-%d B-%d"
- ;; term-ansi-current-underline
- ;; term-ansi-current-reverse
- ;; term-ansi-current-bold
- ;; term-ansi-current-invisible
- ;; term-ansi-face-already-done
- ;; term-ansi-current-color
- ;; term-ansi-current-bg-color)
- (unless term-ansi-face-already-done
- (if term-ansi-current-invisible
- (let ((color
- (if term-ansi-current-reverse
- (face-foreground
- (elt ansi-term-color-vector term-ansi-current-color)
- nil 'default)
- (face-background
- (elt ansi-term-color-vector term-ansi-current-bg-color)
- nil 'default))))
- (setq term-current-face
- (list :background color
- :foreground color))
- ) ;; No need to bother with anything else if it's invisible.
- (setq term-current-face
- (list :foreground
- (face-foreground
- (elt ansi-term-color-vector term-ansi-current-color)
- nil 'default)
- :background
- (face-background
- (elt ansi-term-color-vector term-ansi-current-bg-color)
- nil 'default)
- :inverse-video term-ansi-current-reverse))
- (when term-ansi-current-bold
- (setq term-current-face
- `(,term-current-face :inherit term-bold)))
- (when term-ansi-current-underline
- (setq term-current-face
- `(,term-current-face :inherit term-underline)))))
- ;; (message "Debug %S" term-current-face)
- ;; FIXME: shouldn't we set term-ansi-face-already-done to t here? --Stef
- (setq term-ansi-face-already-done nil))
- ;; Handle a character assuming (eq terminal-state 2) -
- ;; i.e. we have previously seen Escape followed by ?[.
- (defun term-handle-ansi-escape (proc char)
- (cond
- ((or (eq char ?H) ;; cursor motion (terminfo: cup,home)
- ;; (eq char ?f) ;; xterm seems to handle this sequence too, not
- ;; needed for now
- )
- (when (<= term-terminal-parameter 0)
- (setq term-terminal-parameter 1))
- (when (<= term-terminal-previous-parameter 0)
- (setq term-terminal-previous-parameter 1))
- (when (> term-terminal-previous-parameter term-height)
- (setq term-terminal-previous-parameter term-height))
- (when (> term-terminal-parameter term-width)
- (setq term-terminal-parameter term-width))
- (term-goto
- (1- term-terminal-previous-parameter)
- (1- term-terminal-parameter)))
- ;; \E[A - cursor up (terminfo: cuu, cuu1)
- ((eq char ?A)
- (term-handle-deferred-scroll)
- (let ((tcr (term-current-row)))
- (term-down
- (if (< (- tcr term-terminal-parameter) term-scroll-start)
- ;; If the amount to move is before scroll start, move
- ;; to scroll start.
- (- term-scroll-start tcr)
- (if (>= term-terminal-parameter tcr)
- (- tcr)
- (- (max 1 term-terminal-parameter)))) t)))
- ;; \E[B - cursor down (terminfo: cud)
- ((eq char ?B)
- (let ((tcr (term-current-row)))
- (unless (= tcr (1- term-scroll-end))
- (term-down
- (if (> (+ tcr term-terminal-parameter) term-scroll-end)
- (- term-scroll-end 1 tcr)
- (max 1 term-terminal-parameter)) t))))
- ;; \E[C - cursor right (terminfo: cuf, cuf1)
- ((eq char ?C)
- (term-move-columns
- (max 1
- (if (>= (+ term-terminal-parameter (term-current-column)) term-width)
- (- term-width (term-current-column) 1)
- term-terminal-parameter))))
- ;; \E[D - cursor left (terminfo: cub)
- ((eq char ?D)
- (term-move-columns (- (max 1 term-terminal-parameter))))
- ;; \E[J - clear to end of screen (terminfo: ed, clear)
- ((eq char ?J)
- (term-erase-in-display term-terminal-parameter))
- ;; \E[K - clear to end of line (terminfo: el, el1)
- ((eq char ?K)
- (term-erase-in-line term-terminal-parameter))
- ;; \E[L - insert lines (terminfo: il, il1)
- ((eq char ?L)
- (term-insert-lines (max 1 term-terminal-parameter)))
- ;; \E[M - delete lines (terminfo: dl, dl1)
- ((eq char ?M)
- (term-delete-lines (max 1 term-terminal-parameter)))
- ;; \E[P - delete chars (terminfo: dch, dch1)
- ((eq char ?P)
- (term-delete-chars (max 1 term-terminal-parameter)))
- ;; \E[@ - insert spaces (terminfo: ich)
- ((eq char ?@)
- (term-insert-spaces (max 1 term-terminal-parameter)))
- ;; \E[?h - DEC Private Mode Set
- ((eq char ?h)
- (cond ((eq term-terminal-parameter 4) ;; (terminfo: smir)
- (setq term-insert-mode t))
- ;; ((eq term-terminal-parameter 47) ;; (terminfo: smcup)
- ;; (term-switch-to-alternate-sub-buffer t))
- ))
- ;; \E[?l - DEC Private Mode Reset
- ((eq char ?l)
- (cond ((eq term-terminal-parameter 4) ;; (terminfo: rmir)
- (setq term-insert-mode nil))
- ;; ((eq term-terminal-parameter 47) ;; (terminfo: rmcup)
- ;; (term-switch-to-alternate-sub-buffer nil))
- ))
- ;; Modified to allow ansi coloring -mm
- ;; \E[m - Set/reset modes, set bg/fg
- ;;(terminfo: smso,rmso,smul,rmul,rev,bold,sgr0,invis,op,setab,setaf)
- ((eq char ?m)
- (when (= term-terminal-more-parameters 1)
- (when (>= term-terminal-previous-parameter-4 0)
- (term-handle-colors-array term-terminal-previous-parameter-4))
- (when (>= term-terminal-previous-parameter-3 0)
- (term-handle-colors-array term-terminal-previous-parameter-3))
- (when (>= term-terminal-previous-parameter-2 0)
- (term-handle-colors-array term-terminal-previous-parameter-2))
- (term-handle-colors-array term-terminal-previous-parameter))
- (term-handle-colors-array term-terminal-parameter))
- ;; \E[6n - Report cursor position (terminfo: u7)
- ((eq char ?n)
- (term-handle-deferred-scroll)
- (process-send-string proc
- ;; (terminfo: u6)
- (format "\e[%s;%sR"
- (1+ (term-current-row))
- (1+ (term-horizontal-column)))))
- ;; \E[r - Set scrolling region (terminfo: csr)
- ((eq char ?r)
- (term-set-scroll-region
- (1- term-terminal-previous-parameter)
- (1- term-terminal-parameter)))
- (t)))
- (defun term-set-scroll-region (top bottom)
- "Set scrolling region.
- TOP is the top-most line (inclusive) of the new scrolling region,
- while BOTTOM is the line following the new scrolling region (e.g. exclusive).
- The top-most line is line 0."
- (setq term-scroll-start
- (if (or (< top 0) (>= top term-height))
- 0
- top))
- (setq term-scroll-end
- (if (or (<= bottom term-scroll-start) (> bottom term-height))
- term-height
- bottom))
- (setq term-scroll-with-delete
- (or (term-using-alternate-sub-buffer)
- (not (and (= term-scroll-start 0)
- (= term-scroll-end term-height)))))
- (term-move-columns (- (term-current-column)))
- (term-goto 0 0))
- ;; (defun term-switch-to-alternate-sub-buffer (set)
- ;; ;; If asked to switch to (from) the alternate sub-buffer, and already (not)
- ;; ;; using it, do nothing. This test is needed for some programs (including
- ;; ;; Emacs) that emit the ti termcap string twice, for unknown reason.
- ;; (term-handle-deferred-scroll)
- ;; (if (eq set (not (term-using-alternate-sub-buffer)))
- ;; (let ((row (term-current-row))
- ;; (col (term-horizontal-column)))
- ;; (cond (set
- ;; (goto-char (point-max))
- ;; (if (not (eq (preceding-char) ?\n))
- ;; (term-insert-char ?\n 1))
- ;; (setq term-scroll-with-delete t)
- ;; (setq term-saved-home-marker (copy-marker term-home-marker))
- ;; (set-marker term-home-marker (point)))
- ;; (t
- ;; (setq term-scroll-with-delete
- ;; (not (and (= term-scroll-start 0)
- ;; (= term-scroll-end term-height))))
- ;; (set-marker term-home-marker term-saved-home-marker)
- ;; (set-marker term-saved-home-marker nil)
- ;; (setq term-saved-home-marker nil)
- ;; (goto-char term-home-marker)))
- ;; (setq term-current-column nil)
- ;; (setq term-current-row 0)
- ;; (term-goto row col))))
- ;; Default value for the symbol term-command-hook.
- (defun term-command-hook (string)
- (cond ((equal string "")
- t)
- ((= (aref string 0) ?\032)
- ;; gdb (when invoked with -fullname) prints:
- ;; \032\032FULLFILENAME:LINENUMBER:CHARPOS:BEG_OR_MIDDLE:PC\n
- (let* ((first-colon (string-match ":" string 1))
- (second-colon
- (string-match ":" string (1+ first-colon)))
- (filename (substring string 1 first-colon))
- (fileline (string-to-number
- (substring string (1+ first-colon) second-colon))))
- (setq term-pending-frame (cons filename fileline))))
- ((= (aref string 0) ?/)
- (cd (substring string 1)))
- ;; Allowing the inferior to call functions in Emacs is
- ;; probably too big a security hole.
- ;; ((= (aref string 0) ?!)
- ;; (eval (car (read-from-string string 1))))
- (t)));; Otherwise ignore it
- ;; Make sure the file named TRUE-FILE is in a buffer that appears on the screen
- ;; and that its line LINE is visible.
- ;; Put the overlay-arrow on the line LINE in that buffer.
- ;; This is mainly used by gdb.
- (defun term-display-line (true-file line)
- (term-display-buffer-line (find-file-noselect true-file) line))
- (defun term-display-buffer-line (buffer line)
- (let* ((window (display-buffer buffer t))
- (pos))
- (with-current-buffer buffer
- (save-restriction
- (widen)
- (goto-char (point-min))
- (forward-line (1- line))
- (setq pos (point))
- (setq overlay-arrow-string "=>")
- (or overlay-arrow-position
- (setq overlay-arrow-position (make-marker)))
- (set-marker overlay-arrow-position (point) (current-buffer)))
- (cond ((or (< pos (point-min)) (> pos (point-max)))
- (widen)
- (goto-char pos))))
- (set-window-point window overlay-arrow-position)))
- ;; The buffer-local marker term-home-marker defines the "home position"
- ;; (in terms of cursor motion). However, we move the term-home-marker
- ;; "down" as needed so that is no more that a window-full above (point-max).
- (defun term-goto-home ()
- (term-handle-deferred-scroll)
- (goto-char term-home-marker)
- (setq term-current-row 0)
- (setq term-current-column (current-column))
- (setq term-start-line-column term-current-column))
- (defun term-goto (row col)
- (term-handle-deferred-scroll)
- (cond ((and term-current-row (>= row term-current-row))
- ;; I assume this is a worthwhile optimization.
- (term-vertical-motion 0)
- (setq term-current-column term-start-line-column)
- (setq row (- row term-current-row)))
- (t
- (term-goto-home)))
- (term-down row)
- (term-move-columns col))
- ;; The page is full, so enter "pager" mode, and wait for input.
- (defun term-process-pager ()
- ;; (let ((process (get-buffer-process (current-buffer))))
- ;; (stop-process process))
- (setq term-pager-old-local-map (current-local-map))
- (use-local-map term-pager-break-map)
- (easy-menu-add term-terminal-menu)
- (easy-menu-add term-signals-menu)
- (easy-menu-add term-pager-menu)
- (make-local-variable 'term-old-mode-line-format)
- (setq term-old-mode-line-format mode-line-format)
- (setq mode-line-format
- (list "-- **MORE** "
- mode-line-buffer-identification
- " [Type ? for help] "
- "%-"))
- (force-mode-line-update))
- (defun term-pager-line (lines)
- (interactive "p")
- (let* ((moved (vertical-motion (1+ lines)))
- (deficit (- lines moved)))
- (when (> moved lines)
- (backward-char))
- (cond ((<= deficit 0) ;; OK, had enough in the buffer for request.
- (recenter (1- term-height)))
- ((term-pager-continue deficit)))))
- (defun term-pager-page (arg)
- "Proceed past the **MORE** break, allowing the next page of output to appear."
- (interactive "p")
- (term-pager-line (* arg term-height)))
- ;; Pager mode command to go to beginning of buffer.
- (defun term-pager-bob ()
- (interactive)
- (goto-char (point-min))
- (when (= (vertical-motion term-height) term-height)
- (backward-char))
- (recenter (1- term-height)))
- ;; Pager mode command to go to end of buffer.
- (defun term-pager-eob ()
- (interactive)
- (goto-char term-home-marker)
- (recenter 0)
- (goto-char (process-mark (get-buffer-process (current-buffer)))))
- (defun term-pager-back-line (lines)
- (interactive "p")
- (vertical-motion (- 1 lines))
- (if (not (bobp))
- (backward-char)
- (beep)
- ;; Move cursor to end of window.
- (vertical-motion term-height)
- (backward-char))
- (recenter (1- term-height)))
- (defun term-pager-back-page (arg)
- (interactive "p")
- (term-pager-back-line (* arg term-height)))
- (defun term-pager-discard ()
- (interactive)
- (setq term-terminal-parameter "")
- (interrupt-process nil t)
- (term-pager-continue term-height))
- ;; Disable pager processing.
- ;; Only callable while in pager mode. (Contrast term-disable-pager.)
- (defun term-pager-disable ()
- (interactive)
- (if (term-handling-pager)
- (term-pager-continue nil)
- (setq term-pager-count nil))
- (term-update-mode-line))
- ;; Enable pager processing.
- (defun term-pager-enable ()
- (interactive)
- (or (term-pager-enabled)
- (setq term-pager-count 0)) ;; Or maybe set to (term-current-row) ??
- (term-update-mode-line))
- (defun term-pager-toggle ()
- (interactive)
- (if (term-pager-enabled) (term-pager-disable) (term-pager-enable)))
- (defun term-pager-help ()
- "Provide help on commands available in a terminal-emulator **MORE** break."
- (interactive)
- (message "Terminal-emulator pager break help...")
- (sit-for 0)
- (with-electric-help
- (function (lambda ()
- (princ (substitute-command-keys
- "\\<term-pager-break-map>\
- Terminal-emulator MORE break.\n\
- Type one of the following keys:\n\n\
- \\[term-pager-page]\t\tMove forward one page.\n\
- \\[term-pager-line]\t\tMove forward one line.\n\
- \\[universal-argument] N \\[term-pager-page]\tMove N pages forward.\n\
- \\[universal-argument] N \\[term-pager-line]\tMove N lines forward.\n\
- \\[universal-argument] N \\[term-pager-back-line]\tMove N lines back.\n\
- \\[universal-argument] N \\[term-pager-back-page]\t\tMove N pages back.\n\
- \\[term-pager-bob]\t\tMove to the beginning of the buffer.\n\
- \\[term-pager-eob]\t\tMove to the end of the buffer.\n\
- \\[term-pager-discard]\t\tKill pending output and kill process.\n\
- \\[term-pager-disable]\t\tDisable PAGER handling.\n\n\
- \\{term-pager-break-map}\n\
- Any other key is passed through to the program
- running under the terminal emulator and disables pager processing until
- all pending output has been dealt with."))
- nil))))
- (defun term-pager-continue (new-count)
- (let ((process (get-buffer-process (current-buffer))))
- (use-local-map term-pager-old-local-map)
- (setq term-pager-old-local-map nil)
- (setq mode-line-format term-old-mode-line-format)
- (force-mode-line-update)
- (setq term-pager-count new-count)
- (set-process-filter process term-pager-old-filter)
- (funcall term-pager-old-filter process "")
- (continue-process process)))
- ;; Make sure there are DOWN blank lines below the current one.
- ;; Return 0 if we're unable (because of PAGER handling), else return DOWN.
- (defun term-handle-scroll (down)
- (let ((scroll-needed
- (- (+ (term-current-row) down)
- (if (< down 0) term-scroll-start term-scroll-end))))
- (when (or (and (< down 0) (< scroll-needed 0))
- (and (> down 0) (> scroll-needed 0)))
- (let ((save-point (point-marker)) (save-top))
- (goto-char term-home-marker)
- (cond (term-scroll-with-delete
- (if (< down 0)
- (progn
- ;; Delete scroll-needed lines at term-scroll-end,
- ;; then insert scroll-needed lines.
- (term-vertical-motion term-scroll-end)
- (end-of-line)
- (setq save-top (point))
- (term-vertical-motion scroll-needed)
- (end-of-line)
- (delete-region save-top (point))
- (goto-char save-point)
- (setq down (- scroll-needed down))
- (term-vertical-motion down))
- ;; Delete scroll-needed lines at term-scroll-start.
- (term-vertical-motion term-scroll-start)
- (setq save-top (point))
- (term-vertical-motion scroll-needed)
- (delete-region save-top (point))
- (goto-char save-point)
- (term-vertical-motion down)
- (term-adjust-current-row-cache (- scroll-needed)))
- (setq term-current-column nil)
- (term-insert-char ?\n (abs scroll-needed)))
- ((and (numberp term-pager-count)
- (< (setq term-pager-count (- term-pager-count down))
- 0))
- (setq down 0)
- (term-process-pager))
- (t
- (term-adjust-current-row-cache (- scroll-needed))
- (term-vertical-motion scroll-needed)
- (set-marker term-home-marker (point))))
- (goto-char save-point)
- (set-marker save-point nil))))
- down)
- (defun term-down (down &optional check-for-scroll)
- "Move down DOWN screen lines vertically."
- (let ((start-column (term-horizontal-column)))
- (when (and check-for-scroll (or term-scroll-with-delete term-pager-count))
- (setq down (term-handle-scroll down)))
- (unless (and (= term-current-row 0) (< down 0))
- (term-adjust-current-row-cache down)
- (when (or (/= (point) (point-max)) (< down 0))
- (setq down (- down (term-vertical-motion down)))))
- (cond ((>= down 0)
- ;; Extend buffer with extra blank lines if needed.
- (term-insert-char ?\n down)
- (setq term-current-column 0)
- (setq term-start-line-column 0))
- (t
- (when (= term-current-row 0)
- ;; Insert lines if at the beginning.
- (save-excursion (term-insert-char ?\n (- down)))
- (save-excursion
- (let (p)
- ;; Delete lines from the end.
- (forward-line term-height)
- (setq p (point))
- (forward-line (- down))
- (delete-region p (point)))))
- (setq term-current-column 0)
- (setq term-start-line-column (current-column))))
- (when start-column
- (term-move-columns start-column))))
- ;; Assuming point is at the beginning of a screen line,
- ;; if the line above point wraps around, add a ?\n to undo the wrapping.
- ;; FIXME: Probably should be called more than it is.
- (defun term-unwrap-line ()
- (when (not (bolp)) (insert-before-markers ?\n)))
- (defun term-erase-in-line (kind)
- (when (= kind 1) ;; erase left of point
- (let ((cols (term-horizontal-column)) (saved-point (point)))
- (term-vertical-motion 0)
- (delete-region (point) saved-point)
- (term-insert-char ? cols)))
- (when (not (eq kind 1)) ;; erase right of point
- (let ((saved-point (point))
- (wrapped (and (zerop (term-horizontal-column))
- (not (zerop (term-current-column))))))
- (term-vertical-motion 1)
- (delete-region saved-point (point))
- ;; wrapped is true if we're at the beginning of screen line,
- ;; but not a buffer line. If we delete the current screen line
- ;; that will make the previous line no longer wrap, and (because
- ;; of the way Emacs display works) point will be at the end of
- ;; the previous screen line rather then the beginning of the
- ;; current one. To avoid that, we make sure that current line
- ;; contain a space, to force the previous line to continue to wrap.
- ;; We could do this always, but it seems preferable to not add the
- ;; extra space when wrapped is false.
- (when wrapped
- (insert ? ))
- (insert ?\n)
- (put-text-property saved-point (point) 'font-lock-face 'default)
- (goto-char saved-point))))
- (defun term-erase-in-display (kind)
- "Erase (that is blank out) part of the window.
- If KIND is 0, erase from (point) to (point-max);
- if KIND is 1, erase from home to point; else erase from home to point-max."
- (term-handle-deferred-scroll)
- (cond ((eq term-terminal-parameter 0)
- (let ((need-unwrap (bolp)))
- (delete-region (point) (point-max))
- (when need-unwrap (term-unwrap-line))))
- ((let ((row (term-current-row))
- (col (term-horizontal-column))
- (start-region term-home-marker)
- (end-region (if (eq kind 1) (point) (point-max))))
- (delete-region start-region end-region)
- (term-unwrap-line)
- (when (eq kind 1)
- (term-insert-char ?\n row))
- (setq term-current-column nil)
- (setq term-current-row nil)
- (term-goto row col)))))
- (defun term-delete-chars (count)
- (let ((save-point (point)))
- (term-vertical-motion 1)
- (term-unwrap-line)
- (goto-char save-point)
- (move-to-column (+ (term-current-column) count) t)
- (delete-region save-point (point))))
- ;; Insert COUNT spaces after point, but do not change any of
- ;; following screen lines. Hence we may have to delete characters
- ;; at the end of this screen line to make room.
- (defun term-insert-spaces (count)
- (let ((save-point (point)) (save-eol) (pnt-at-eol))
- (term-vertical-motion 1)
- (when (bolp)
- (backward-char))
- (setq save-eol (point)
- pnt-at-eol (line-end-position))
- (move-to-column (+ (term-start-line-column) (- term-width count)) t)
- ;; If move-to-column extends the current line it will use the face
- ;; from the last character on the line, set the face for the chars
- ;; to default.
- (when (>= (point) pnt-at-eol)
- (put-text-property pnt-at-eol (point) 'font-lock-face 'default))
- (when (> save-eol (point))
- (delete-region (point) save-eol))
- (goto-char save-point)
- (term-insert-char ? count)
- (goto-char save-point)))
- (defun term-delete-lines (lines)
- (let ((start (point))
- (save-current-column term-current-column)
- (save-start-line-column term-start-line-column)
- (save-current-row (term-current-row)))
- ;; The number of inserted lines shouldn't exceed the scroll region end.
- ;; The `term-scroll-end' line is part of the scrolling region, so
- ;; we need to go one line past it in order to ensure correct
- ;; scrolling.
- (when (> (+ save-current-row lines) (1+ term-scroll-end))
- (setq lines (- lines (- (+ save-current-row lines) (1+ term-scroll-end)))))
- (term-down lines)
- (delete-region start (point))
- (term-down (- (1+ term-scroll-end) save-current-row lines))
- (term-insert-char ?\n lines)
- (setq term-current-column save-current-column)
- (setq term-start-line-column save-start-line-column)
- (setq term-current-row save-current-row)
- (goto-char start)))
- (defun term-insert-lines (lines)
- (let ((start (point))
- (start-deleted)
- (save-current-column term-current-column)
- (save-start-line-column term-start-line-column)
- (save-current-row (term-current-row)))
- ;; Inserting lines should take into account the scroll region.
- ;; The `term-scroll-end' line is part of the scrolling region, so
- ;; we need to go one line past it in order to ensure correct
- ;; scrolling.
- (if (< save-current-row term-scroll-start)
- ;; If point is before scroll start,
- (progn
- (setq lines (- lines (- term-scroll-start save-current-row)))
- (term-down (- term-scroll-start save-current-row))
- (setq start (point)))
- ;; The number of inserted lines shouldn't exceed the scroll region end.
- (when (> (+ save-current-row lines) (1+ term-scroll-end))
- (setq lines (- lines (- (+ save-current-row lines)(1+ term-scroll-end)))))
- (term-down (- (1+ term-scroll-end) save-current-row lines)))
- (setq start-deleted (point))
- (term-down lines)
- (delete-region start-deleted (point))
- (goto-char start)
- (setq term-current-column save-current-column)
- (setq term-start-line-column save-start-line-column)
- (setq term-current-row save-current-row)
- (term-insert-char ?\n lines)
- (goto-char start)))
- (defun term-start-output-log (name)
- "Record raw inferior process output in a buffer."
- (interactive (list (if term-log-buffer
- nil
- (read-buffer "Record output in buffer: "
- (format "%s output-log"
- (buffer-name (current-buffer)))
- nil))))
- (if (or (null name) (equal name ""))
- (progn (setq term-log-buffer nil)
- (message "Output logging off."))
- (if (get-buffer name)
- nil
- (with-current-buffer (get-buffer-create name)
- (fundamental-mode)
- (buffer-disable-undo (current-buffer))
- (erase-buffer)))
- (setq term-log-buffer (get-buffer name))
- (message "Recording terminal emulator output into buffer \"%s\""
- (buffer-name term-log-buffer))))
- (defun term-stop-output-log ()
- "Discontinue raw inferior process logging."
- (interactive)
- (term-start-output-log nil))
- (defun term-show-maximum-output ()
- "Put the end of the buffer at the bottom of the window."
- (interactive)
- (goto-char (point-max))
- (recenter -1))
- ;;; Do the user's customization...
- (defvar term-load-hook nil
- "This hook is run when term is loaded in.
- This is a good place to put keybindings.")
- (run-hooks 'term-load-hook)
- ;;; Filename/command/history completion in a buffer
- ;; ===========================================================================
- ;; Useful completion functions, courtesy of the Ergo group.
- ;; Six commands:
- ;; term-dynamic-complete Complete or expand command, filename,
- ;; history at point.
- ;; term-dynamic-complete-filename Complete filename at point.
- ;; term-dynamic-list-filename-completions List completions in help buffer.
- ;; term-replace-by-expanded-filename Expand and complete filename at point;
- ;; replace with expanded/completed name.
- ;; These are not installed in the term-mode keymap. But they are
- ;; available for people who want them. Shell-mode installs them:
- ;; (define-key shell-mode-map "\t" 'term-dynamic-complete)
- ;; (define-key shell-mode-map "\M-?"
- ;; 'term-dynamic-list-filename-completions)))
- ;;
- ;; Commands like this are fine things to put in load hooks if you
- ;; want them present in specific modes.
- (defcustom term-completion-autolist nil
- "If non-nil, automatically list possibilities on partial completion.
- This mirrors the optional behavior of tcsh."
- :group 'term
- :type 'boolean)
- (defcustom term-completion-addsuffix t
- "If non-nil, add a `/' to completed directories, ` ' to file names.
- If a cons pair, it should be of the form (DIRSUFFIX . FILESUFFIX) where
- DIRSUFFIX and FILESUFFIX are strings added on unambiguous or exact
- completion. This mirrors the optional behavior of tcsh."
- :group 'term
- :type '(choice (const :tag "No suffix" nil)
- (cons (string :tag "dirsuffix") (string :tag "filesuffix"))
- (other :tag "Suffix" t)))
- (defcustom term-completion-recexact nil
- "If non-nil, use shortest completion if characters cannot be added.
- This mirrors the optional behavior of tcsh.
- A non-nil value is useful if `term-completion-autolist' is non-nil too."
- :group 'term
- :type 'boolean)
- (defcustom term-completion-fignore nil
- "List of suffixes to be disregarded during file completion.
- This mirrors the optional behavior of bash and tcsh.
- Note that this applies to `term-dynamic-complete-filename' only."
- :group 'term
- :type '(choice (const nil)
- (repeat :tag "List of suffixes" string)))
- (defvar term-file-name-prefix ""
- "Prefix prepended to absolute file names taken from process input.
- This is used by term's and shell's completion functions, and by shell's
- directory tracking functions.")
- (defun term-directory (directory)
- ;; Return expanded DIRECTORY, with `term-file-name-prefix' if absolute.
- (expand-file-name (if (file-name-absolute-p directory)
- (concat term-file-name-prefix directory)
- directory)))
- (defun term-word (word-chars)
- "Return the word of WORD-CHARS at point, or nil if none is found.
- Word constituents are considered to be those in WORD-CHARS, which is like the
- inside of a \"[...]\" (see `skip-chars-forward')."
- (save-excursion
- (let ((limit (point))
- (word (concat "[" word-chars "]"))
- (non-word (concat "[^" word-chars "]")))
- (when (re-search-backward non-word nil 'move)
- (forward-char 1))
- ;; Anchor the search forwards.
- (if (or (eolp) (looking-at non-word))
- nil
- (re-search-forward (concat word "+") limit)
- (buffer-substring (match-beginning 0) (match-end 0))))))
- (defun term-match-partial-filename ()
- "Return the filename at point, or nil if none is found.
- Environment variables are substituted. See `term-word'."
- (let ((filename (term-word "~/A-Za-z0-9+@:_.$#,={}-")))
- (and filename (substitute-in-file-name filename))))
- (defun term-dynamic-complete ()
- "Dynamically perform completion at point.
- Calls the functions in `term-dynamic-complete-functions' to perform
- completion until a function returns non-nil, at which point completion is
- assumed to have occurred."
- (interactive)
- (let ((functions term-dynamic-complete-functions))
- (while (and functions (null (funcall (car functions))))
- (setq functions (cdr functions)))))
- (defun term-dynamic-complete-filename ()
- "Dynamically complete the filename at point.
- Completes if after a filename. See `term-match-partial-filename' and
- `term-dynamic-complete-as-filename'.
- This function is similar to `term-replace-by-expanded-filename', except that
- it won't change parts of the filename already entered in the buffer; it just
- adds completion characters to the end of the filename. A completions listing
- may be shown in a help buffer if completion is ambiguous.
- Completion is dependent on the value of `term-completion-addsuffix',
- `term-completion-recexact' and `term-completion-fignore', and the timing of
- completions listing is dependent on the value of `term-completion-autolist'.
- Returns t if successful."
- (interactive)
- (when (term-match-partial-filename)
- (prog2 (or (eq (selected-window) (minibuffer-window))
- (message "Completing file name..."))
- (term-dynamic-complete-as-filename))))
- (defun term-dynamic-complete-as-filename ()
- "Dynamically complete at point as a filename.
- See `term-dynamic-complete-filename'. Returns t if successful."
- (let* ((completion-ignore-case nil)
- (completion-ignored-extensions term-completion-fignore)
- (success t)
- (dirsuffix (cond ((not term-completion-addsuffix) "")
- ((not (consp term-completion-addsuffix)) "/")
- (t (car term-completion-addsuffix))))
- (filesuffix (cond ((not term-completion-addsuffix) "")
- ((not (consp term-completion-addsuffix)) " ")
- (t (cdr term-completion-addsuffix))))
- (filename (or (term-match-partial-filename) ""))
- (pathdir (file-name-directory filename))
- (pathnondir (file-name-nondirectory filename))
- (directory (if pathdir (term-directory pathdir) default-directory))
- (completion (file-name-completion pathnondir directory))
- (mini-flag (eq (selected-window) (minibuffer-window))))
- (cond ((null completion)
- (message "No completions of %s" filename)
- (setq success nil))
- ((eq completion t) ; Means already completed "file".
- (when term-completion-addsuffix (insert " "))
- (or mini-flag (message "Sole completion")))
- ((string-equal completion "") ; Means completion on "directory/".
- (term-dynamic-list-filename-completions))
- (t ; Completion string returned.
- (let ((file (concat (file-name-as-directory directory) completion)))
- (insert (substring (directory-file-name completion)
- (length pathnondir)))
- (cond ((symbolp (file-name-completion completion directory))
- ;; We inserted a unique completion.
- (insert (if (file-directory-p file) dirsuffix filesuffix))
- (or mini-flag (message "Completed")))
- ((and term-completion-recexact term-completion-addsuffix
- (string-equal pathnondir completion)
- (file-exists-p file))
- ;; It's not unique, but user wants shortest match.
- (insert (if (file-directory-p file) dirsuffix filesuffix))
- (or mini-flag (message "Completed shortest")))
- ((or term-completion-autolist
- (string-equal pathnondir completion))
- ;; It's not unique, list possible completions.
- (term-dynamic-list-filename-completions))
- (t
- (or mini-flag (message "Partially completed")))))))
- success))
- (defun term-replace-by-expanded-filename ()
- "Dynamically expand and complete the filename at point.
- Replace the filename with an expanded, canonicalized and completed replacement.
- \"Expanded\" means environment variables (e.g., $HOME) and `~'s are replaced
- with the corresponding directories. \"Canonicalized\" means `..' and `.' are
- removed, and the filename is made absolute instead of relative. For expansion
- see `expand-file-name' and `substitute-in-file-name'. For completion see
- `term-dynamic-complete-filename'."
- (interactive)
- (replace-match (expand-file-name (term-match-partial-filename)) t t)
- (term-dynamic-complete-filename))
- (defun term-dynamic-simple-complete (stub candidates)
- "Dynamically complete STUB from CANDIDATES list.
- This function inserts completion characters at point by completing STUB from
- the strings in CANDIDATES. A completions listing may be shown in a help buffer
- if completion is ambiguous.
- Returns nil if no completion was inserted.
- Returns `sole' if completed with the only completion match.
- Returns `shortest' if completed with the shortest of the completion matches.
- Returns `partial' if completed as far as possible with the completion matches.
- Returns `listed' if a completion listing was shown.
- See also `term-dynamic-complete-filename'."
- (declare (obsolete completion-in-region "23.2"))
- (let* ((completion-ignore-case nil)
- (candidates (mapcar (function (lambda (x) (list x))) candidates))
- (completions (all-completions stub candidates)))
- (cond ((null completions)
- (message "No completions of %s" stub)
- nil)
- ((= 1 (length completions)) ; Gotcha!
- (let ((completion (car completions)))
- (if (string-equal completion stub)
- (message "Sole completion")
- (insert (substring completion (length stub)))
- (message "Completed"))
- (when term-completion-addsuffix (insert " "))
- 'sole))
- (t ; There's no unique completion.
- (let ((completion (try-completion stub candidates)))
- ;; Insert the longest substring.
- (insert (substring completion (length stub)))
- (cond ((and term-completion-recexact term-completion-addsuffix
- (string-equal stub completion)
- (member completion completions))
- ;; It's not unique, but user wants shortest match.
- (insert " ")
- (message "Completed shortest")
- 'shortest)
- ((or term-completion-autolist
- (string-equal stub completion))
- ;; It's not unique, list possible completions.
- (term-dynamic-list-completions completions)
- 'listed)
- (t
- (message "Partially completed")
- 'partial)))))))
- (defun term-dynamic-list-filename-completions ()
- "List in help buffer possible completions of the filename at point."
- (interactive)
- (let* ((completion-ignore-case nil)
- (filename (or (term-match-partial-filename) ""))
- (pathdir (file-name-directory filename))
- (pathnondir (file-name-nondirectory filename))
- (directory (if pathdir (term-directory pathdir) default-directory))
- (completions (file-name-all-completions pathnondir directory)))
- (if completions
- (term-dynamic-list-completions completions)
- (message "No completions of %s" filename))))
- (defun term-dynamic-list-completions (completions)
- "List in help buffer sorted COMPLETIONS.
- Typing SPC flushes the help buffer."
- (let ((conf (current-window-configuration)))
- (with-output-to-temp-buffer "*Completions*"
- (display-completion-list (sort completions 'string-lessp)))
- (message "Hit space to flush")
- (let (key first)
- (if (with-current-buffer (get-buffer "*Completions*")
- (setq key (read-key-sequence nil)
- first (aref key 0))
- (and (consp first)
- (eq (window-buffer (posn-window (event-start first)))
- (get-buffer "*Completions*"))
- (memq (key-binding key)
- '(mouse-choose-completion choose-completion))))
- ;; If the user does choose-completion with the mouse,
- ;; execute the command, then delete the completion window.
- (progn
- (choose-completion first)
- (set-window-configuration conf))
- (if (eq first ?\s)
- (set-window-configuration conf)
- (setq unread-command-events
- (nconc (listify-key-sequence key)
- unread-command-events)))))))
- ;; I need a make-term that doesn't surround with *s -mm
- (defun term-ansi-make-term (name program &optional startfile &rest switches)
- "Make a term process NAME in a buffer, running PROGRAM.
- The name of the buffer is NAME.
- If there is already a running process in that buffer, it is not restarted.
- Optional third arg STARTFILE is the name of a file to send the contents of to
- the process. Any more args are arguments to PROGRAM."
- (let ((buffer (get-buffer-create name )))
- ;; If no process, or nuked process, crank up a new one and put buffer in
- ;; term mode. Otherwise, leave buffer and existing process alone.
- (cond ((not (term-check-proc buffer))
- (with-current-buffer buffer
- (term-mode)) ; Install local vars, mode, keymap, ...
- (term-exec buffer name program startfile switches)))
- buffer))
- (defvar term-ansi-buffer-name nil)
- (defvar term-ansi-default-program nil)
- (defvar term-ansi-buffer-base-name nil)
- ;;;###autoload
- (defun ansi-term (program &optional new-buffer-name)
- "Start a terminal-emulator in a new buffer."
- (interactive (list (read-from-minibuffer "Run program: "
- (or explicit-shell-file-name
- (getenv "ESHELL")
- (getenv "SHELL")
- "/bin/sh"))))
- ;; Pick the name of the new buffer.
- (setq term-ansi-buffer-name
- (if new-buffer-name
- new-buffer-name
- (if term-ansi-buffer-base-name
- (if (eq term-ansi-buffer-base-name t)
- (file-name-nondirectory program)
- term-ansi-buffer-base-name)
- "ansi-term")))
- (setq term-ansi-buffer-name (concat "*" term-ansi-buffer-name "*"))
- ;; In order to have more than one term active at a time
- ;; I'd like to have the term names have the *term-ansi-term<?>* form,
- ;; for now they have the *term-ansi-term*<?> form but we'll see...
- (setq term-ansi-buffer-name (generate-new-buffer-name term-ansi-buffer-name))
- (setq term-ansi-buffer-name (term-ansi-make-term term-ansi-buffer-name program))
- (set-buffer term-ansi-buffer-name)
- (term-mode)
- (term-char-mode)
- ;; Historical baggage. A call to term-set-escape-char used to not
- ;; undo any previous call to t-s-e-c. Because of this, ansi-term
- ;; ended up with both C-x and C-c as escape chars. Who knows what
- ;; the original intention was, but people could have become used to
- ;; either. (Bug#12842)
- (let (term-escape-char)
- ;; I wanna have find-file on C-x C-f -mm
- ;; your mileage may definitely vary, maybe it's better to put this in your
- ;; .emacs ...
- (term-set-escape-char ?\C-x))
- (switch-to-buffer term-ansi-buffer-name))
- ;;; Serial terminals
- ;; ===========================================================================
- (defun serial-port-is-file-p ()
- "Guess whether serial ports are files on this system.
- Return t if this is a Unix-based system, where serial ports are
- files, such as /dev/ttyS0.
- Return nil if this is Windows or DOS, where serial ports have
- special identifiers such as COM1."
- (not (memq system-type '(windows-nt cygwin ms-dos))))
- (defvar serial-name-history
- (if (serial-port-is-file-p)
- (or (when (file-exists-p "/dev/ttys0") (list "/dev/ttys0"))
- (when (file-exists-p "/dev/ttyS0") (list "/dev/ttyS0")))
- (list "COM1"))
- "History of serial ports used by `serial-read-name'.")
- (defvar serial-speed-history
- ;; Initialized with reasonable values for newbies.
- (list "9600" ;; Given twice because 9600 b/s is the most common speed
- "1200" "2400" "4800" "9600" "14400" "19200"
- "28800" "38400" "57600" "115200")
- "History of serial port speeds used by `serial-read-speed'.")
- (defun serial-nice-speed-history ()
- "Return `serial-speed-history' cleaned up for a mouse-menu."
- (let ((x) (y))
- (setq x
- (sort
- (copy-sequence serial-speed-history)
- (lambda (a b) (when (and (stringp a) (stringp b))
- (> (string-to-number a) (string-to-number b))))))
- (dolist (i x) (when (not (equal i (car y))) (push i y)))
- y))
- (defconst serial-no-speed "nil"
- "String for `serial-read-speed' for special serial ports.
- If `serial-read-speed' reads this string from the user, it
- returns nil, which is recognized by `serial-process-configure'
- for special serial ports that cannot be configured.")
- (defun serial-supported-or-barf ()
- "Signal an error if serial processes are not supported."
- (unless (fboundp 'make-serial-process)
- (error "Serial processes are not supported on this system")))
- (defun serial-read-name ()
- "Read a serial port name from the user.
- Try to be nice by providing useful defaults and history.
- On Windows, prepend \\.\ to the port name unless it already
- contains a backslash. This handles the legacy ports COM1-COM9 as
- well as the newer ports COM10 and higher."
- (serial-supported-or-barf)
- (let* ((file-name-history serial-name-history)
- (h (car file-name-history))
- (x (if (serial-port-is-file-p)
- (read-file-name
- ;; `prompt': The most recently used port is provided as
- ;; the default value, which is used when the user
- ;; simply presses return.
- (if (stringp h) (format "Serial port (default %s): " h)
- "Serial port: ")
- ;; `directory': Most systems have their serial ports
- ;; in the same directory, so start in the directory
- ;; of the most recently used port, or in a reasonable
- ;; default directory.
- (or (and h (file-name-directory h))
- (and (file-exists-p "/dev/") "/dev/")
- (and (file-exists-p "/") "/"))
- ;; `default': This causes (read-file-name) to return
- ;; the empty string if he user simply presses return.
- ;; Using nil here may result in a default directory
- ;; of the current buffer, which is not useful for
- ;; serial port.
- "")
- (read-from-minibuffer
- (if (stringp h) (format "Serial port (default %s): " h)
- "Serial port: ")
- nil nil nil '(file-name-history . 1) nil nil))))
- (if (or (null x) (and (stringp x) (zerop (length x))))
- (setq x h)
- (setq serial-name-history file-name-history))
- (when (or (null x) (and (stringp x) (zerop (length x))))
- (error "No serial port selected"))
- (when (and (not (serial-port-is-file-p))
- (not (string-match "\\\\" x)))
- (set 'x (concat "\\\\.\\" x)))
- x))
- (defun serial-read-speed ()
- "Read a serial port speed (in bits per second) from the user.
- Try to be nice by providing useful defaults and history."
- (serial-supported-or-barf)
- (let* ((history serial-speed-history)
- (h (car history))
- (x (read-from-minibuffer
- (cond ((string= h serial-no-speed)
- "Speed (default nil = set by port): ")
- (h
- (format "Speed (default %s b/s): " h))
- (t
- (format "Speed (b/s): ")))
- nil nil nil '(history . 1) nil nil)))
- (when (or (null x) (and (stringp x) (zerop (length x))))
- (setq x h))
- (when (or (null x) (not (stringp x)) (zerop (length x)))
- (error "Invalid speed"))
- (if (string= x serial-no-speed)
- (setq x nil)
- (setq x (string-to-number x))
- (when (or (null x) (not (integerp x)) (<= x 0))
- (error "Invalid speed")))
- (setq serial-speed-history history)
- x))
- ;;;###autoload
- (defun serial-term (port speed)
- "Start a terminal-emulator for a serial port in a new buffer.
- PORT is the path or name of the serial port. For example, this
- could be \"/dev/ttyS0\" on Unix. On Windows, this could be
- \"COM1\" or \"\\\\.\\COM10\".
- SPEED is the speed of the serial port in bits per second. 9600
- is a common value. SPEED can be nil, see
- `serial-process-configure' for details.
- The buffer is in Term mode; see `term-mode' for the commands to
- use in that buffer.
- \\<term-raw-map>Type \\[switch-to-buffer] to switch to another buffer."
- (interactive (list (serial-read-name) (serial-read-speed)))
- (serial-supported-or-barf)
- (let* ((process (make-serial-process
- :port port
- :speed speed
- :coding 'no-conversion
- :noquery t))
- (buffer (process-buffer process)))
- (with-current-buffer buffer
- (term-mode)
- (term-char-mode)
- (goto-char (point-max))
- (set-marker (process-mark process) (point))
- (set-process-filter process 'term-emulate-terminal)
- (set-process-sentinel process 'term-sentinel))
- (switch-to-buffer buffer)
- buffer))
- (defvar serial-mode-line-speed-menu nil)
- (defvar serial-mode-line-config-menu nil)
- (defun serial-speed ()
- "Return the speed of the serial port of the current buffer's process.
- The return value may be nil for a special serial port."
- (process-contact (get-buffer-process (current-buffer)) :speed))
- (defun serial-mode-line-speed-menu-1 (event)
- (interactive "e")
- (save-selected-window
- (select-window (posn-window (event-start event)))
- (serial-update-speed-menu)
- (let* ((selection (serial-mode-line-speed-menu event))
- (binding (and selection (lookup-key serial-mode-line-speed-menu
- (vector (car selection))))))
- (when binding (call-interactively binding)))))
- (defun serial-mode-line-speed-menu (event)
- (x-popup-menu event serial-mode-line-speed-menu))
- (defun serial-update-speed-menu ()
- (setq serial-mode-line-speed-menu (make-sparse-keymap "Speed (b/s)"))
- (define-key serial-mode-line-speed-menu [serial-mode-line-speed-menu-other]
- '(menu-item "Other..."
- (lambda (event) (interactive "e")
- (let ((speed (serial-read-speed)))
- (serial-process-configure :speed speed)
- (term-update-mode-line)
- (message "Speed set to %d b/s" speed)))))
- (dolist (str (serial-nice-speed-history))
- (let ((num (or (and (stringp str) (string-to-number str)) 0)))
- (define-key
- serial-mode-line-speed-menu
- (vector (make-symbol (format "serial-mode-line-speed-menu-%s" str)))
- `(menu-item
- ,str
- (lambda (event) (interactive "e")
- (serial-process-configure :speed ,num)
- (term-update-mode-line)
- (message "Speed set to %d b/s" ,num))
- :button (:toggle . (= (serial-speed) ,num)))))))
- (defun serial-mode-line-config-menu-1 (event)
- (interactive "e")
- (save-selected-window
- (select-window (posn-window (event-start event)))
- (serial-update-config-menu)
- (let* ((selection (serial-mode-line-config-menu event))
- (binding (and selection (lookup-key serial-mode-line-config-menu
- (vector (car selection))))))
- (when binding (call-interactively binding)))))
- (defun serial-mode-line-config-menu (event)
- (x-popup-menu event serial-mode-line-config-menu))
- (defun serial-update-config-menu ()
- (setq serial-mode-line-config-menu (make-sparse-keymap "Configuration"))
- (let ((config (process-contact
- (get-buffer-process (current-buffer)) t)))
- (dolist (y '((:flowcontrol hw "Hardware flowcontrol (RTS/CTS)")
- (:flowcontrol sw "Software flowcontrol (XON/XOFF)")
- (:flowcontrol nil "No flowcontrol")
- (:stopbits 2 "2 stopbits")
- (:stopbits 1 "1 stopbit")
- (:parity odd "Odd parity")
- (:parity even "Even parity")
- (:parity nil "No parity")
- (:bytesize 7 "7 bits per byte")
- (:bytesize 8 "8 bits per byte")))
- (define-key serial-mode-line-config-menu
- (vector (make-symbol (format "%s-%s" (nth 0 y) (nth 1 y))))
- `(menu-item
- ,(nth 2 y)
- (lambda (event) (interactive "e")
- (serial-process-configure ,(nth 0 y) ',(nth 1 y))
- (term-update-mode-line)
- (message "%s" ,(nth 2 y)))
- ;; Use :toggle instead of :radio because a non-standard port
- ;; configuration may not match any menu items.
- :button (:toggle . ,(equal (plist-get config (nth 0 y))
- (nth 1 y))))))))
- ;;; Converting process modes to use term mode
- ;; ===========================================================================
- ;; Renaming variables
- ;; Most of the work is renaming variables and functions. These are the common
- ;; ones:
- ;; Local variables:
- ;; last-input-start term-last-input-start
- ;; last-input-end term-last-input-end
- ;; shell-prompt-pattern term-prompt-regexp
- ;; shell-set-directory-error-hook <no equivalent>
- ;; Miscellaneous:
- ;; shell-set-directory <unnecessary>
- ;; shell-mode-map term-mode-map
- ;; Commands:
- ;; shell-send-input term-send-input
- ;; shell-send-eof term-delchar-or-maybe-eof
- ;; kill-shell-input term-kill-input
- ;; interrupt-shell-subjob term-interrupt-subjob
- ;; stop-shell-subjob term-stop-subjob
- ;; quit-shell-subjob term-quit-subjob
- ;; kill-shell-subjob term-kill-subjob
- ;; kill-output-from-shell term-kill-output
- ;; show-output-from-shell term-show-output
- ;; copy-last-shell-input Use term-previous-input/term-next-input
- ;;
- ;; SHELL-SET-DIRECTORY is gone, its functionality taken over by
- ;; SHELL-DIRECTORY-TRACKER, the shell mode's term-input-filter-functions.
- ;; Term mode does not provide functionality equivalent to
- ;; shell-set-directory-error-hook; it is gone.
- ;;
- ;; term-last-input-start is provided for modes which want to munge
- ;; the buffer after input is sent, perhaps because the inferior
- ;; insists on echoing the input. The LAST-INPUT-START variable in
- ;; the old shell package was used to implement a history mechanism,
- ;; but you should think twice before using term-last-input-start
- ;; for this; the input history ring often does the job better.
- ;;
- ;; If you are implementing some process-in-a-buffer mode, called foo-mode, do
- ;; *not* create the term-mode local variables in your foo-mode function.
- ;; This is not modular. Instead, call term-mode, and let *it* create the
- ;; necessary term-specific local variables. Then create the
- ;; foo-mode-specific local variables in foo-mode. Set the buffer's keymap to
- ;; be foo-mode-map, and its mode to be foo-mode. Set the term-mode hooks
- ;; (term-{prompt-regexp, input-filter, input-filter-functions,
- ;; get-old-input) that need to be different from the defaults. Call
- ;; foo-mode-hook, and you're done. Don't run the term-mode hook yourself;
- ;; term-mode will take care of it. The following example, from shell.el,
- ;; is typical:
- ;;
- ;; (defvar shell-mode-map '())
- ;; (cond ((not shell-mode-map)
- ;; (setq shell-mode-map (copy-keymap term-mode-map))
- ;; (define-key shell-mode-map "\C-c\C-f" 'shell-forward-command)
- ;; (define-key shell-mode-map "\C-c\C-b" 'shell-backward-command)
- ;; (define-key shell-mode-map "\t" 'term-dynamic-complete)
- ;; (define-key shell-mode-map "\M-?"
- ;; 'term-dynamic-list-filename-completions)))
- ;;
- ;; (defun shell-mode ()
- ;; (interactive)
- ;; (term-mode)
- ;; (setq term-prompt-regexp shell-prompt-pattern)
- ;; (setq major-mode 'shell-mode)
- ;; (setq mode-name "Shell")
- ;; (use-local-map shell-mode-map)
- ;; (make-local-variable 'shell-directory-stack)
- ;; (setq shell-directory-stack nil)
- ;; (add-hook 'term-input-filter-functions 'shell-directory-tracker)
- ;; (run-mode-hooks 'shell-mode-hook))
- ;;
- ;;
- ;; Completion for term-mode users
- ;;
- ;; For modes that use term-mode, term-dynamic-complete-functions is the
- ;; hook to add completion functions to. Functions on this list should return
- ;; non-nil if completion occurs (i.e., further completion should not occur).
- ;; You could use completion-in-region to do the bulk of the
- ;; completion job.
- (provide 'term)
- ;;; term.el ends here
|