RELEASE-NOTES-TMP.xml 624 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056120571205812059120601206112062120631206412065120661206712068120691207012071120721207312074120751207612077120781207912080120811208212083120841208512086120871208812089120901209112092120931209412095120961209712098120991210012101121021210312104121051210612107121081210912110121111211212113121141211512116121171211812119121201212112122121231212412125121261212712128121291213012131121321213312134121351213612137121381213912140121411214212143121441214512146121471214812149121501215112152121531215412155121561215712158121591216012161121621216312164121651216612167121681216912170
  1. <?xml version="1.0"?>
  2. <article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:lang="en" xml:id="releasenotes" version="5.0">
  3. <info>
  4. <title>Release Notes for the DocBook XSL Stylesheets</title>
  5. <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
  6. <releaseinfo role="cvs">$Revision: 9401 $ $Date: 2012-06-04 21:47:26 +0000 (Mon, 04 Jun 2012) $</releaseinfo>
  7. <!-- * <author><orgname>DocBook Project Development Team</orgname></author> -->
  8. <abstract>
  9. <para condition="dot-zero;dot-one-plus">This release-notes
  10. document is available in the following formats:
  11. <link xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html">HTML</link>,
  12. <link xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.pdf">PDF</link>,
  13. <link xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.txt">plain text</link>; it provides a per-release list
  14. of enhancements and changes to the stylesheets&#x2019; public APIs
  15. (user-configurable parameters) and excludes descriptions of most
  16. bug fixes. For a complete list of all changes (including all bug
  17. fixes) that have been made since the previous release, see the
  18. separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link xlink:href="NEWS.html">NEWS.html</link> files. Also available:
  19. An online <link xlink:href="http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log">hyperlinked change history</link> (warning: big file) of all
  20. changes made over the entire history of the codebase.</para>
  21. <para condition="dot-zero">As with all DocBook Project <link linkend="dot0">dot-zero</link> releases, this is an
  22. experimental release. It will be followed shortly by a stable
  23. release.</para>
  24. <para condition="dot-one-plus">As with all DocBook Project &#x201C;dot
  25. one plus&#x201D; releases, this release aspires to be stable (in
  26. contrast to <link linkend="dot0">dot-zero</link> releases, which
  27. are experimental).</para>
  28. <para condition="snapshot">This is a pre-release &#x201C;snapshot&#x201D; of the
  29. DocBook XSL Stylesheets. The change information in the first
  30. section of this file
  31. (for &#x201C;Release Notes: 1.78.1&#x201D;) is
  32. auto-generated from change descriptions stored in the project
  33. source-code repository.</para>
  34. <para condition="snapshot">That means the first section contains
  35. descriptions both of bug fixes and of feature changes. The
  36. remaining sections are manually edited changelog subsets that
  37. exclude bug-fix descriptions &#x2013; that is, trimmed down to just those
  38. those descriptions that document enhancements and changes to the
  39. public APIs (user-configurable parameters).</para>
  40. </abstract>
  41. </info>
  42. <sect1 condition="snapshot" xml:id="current">
  43. <title>Release Notes: 1.78.1</title><para>The following is a list of changes that have been made
  44. since the 1.78.0 release.</para><sect2 xml:id="V1.78.1_Common">
  45. <title>Common</title>
  46. <para>The following changes have been made to the
  47. <filename>common</filename> code
  48. since the 1.78.0 release.</para>
  49. <itemizedlist>
  50. <listitem>
  51. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Make sure part and set <tag>titleabbrev</tag> are used in mode="titleabbrev.markup"</phrase></screen>
  52. </listitem>
  53. <listitem>
  54. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add empty default template for <tag>titleabbrev</tag> since it is always processed in a mode.</phrase></screen>
  55. </listitem>
  56. <listitem>
  57. <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  58. </listitem>
  59. <listitem>
  60. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">for missing <tag>title</tag> in <tag>xref</tag>, provide parent information of target to help locate problem element.
  61. Process <tag>bridgehead</tag> in mode="title.markup", not normal mode.</phrase></screen>
  62. </listitem>
  63. <listitem>
  64. <para><literal>Jirka Kosek: l10n.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #3598963</phrase></screen>
  65. </listitem>
  66. <listitem>
  67. <para><literal>Robert Stayton: gentext.xsl; labels.xsl</literal></para><screen><phrase role="commit-message">Make sure bridgeheads are not numbered in all contexts, including html <tag>title</tag> attributes.</phrase></screen>
  68. </listitem>
  69. </itemizedlist>
  70. </sect2><sect2 xml:id="V1.78.1_FO">
  71. <title>FO</title>
  72. <para>The following changes have been made to the
  73. <filename>fo</filename> code
  74. since the 1.78.0 release.</para>
  75. <itemizedlist>
  76. <listitem>
  77. <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Fix bug where part <tag>TOC</tag> not generated when <tag>partintro</tag> is present.</phrase></screen>
  78. </listitem>
  79. <listitem>
  80. <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">Footnotes can't be placed into fo:float</phrase></screen>
  81. </listitem>
  82. <listitem>
  83. <para><literal>Robert Stayton: titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Remove margin-left when start-indent is used because they interfere
  84. with each other.</phrase></screen>
  85. </listitem>
  86. <listitem>
  87. <para><literal>Robert Stayton: fo.xsl; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Use dingbat.fontset rather than <parameter>dingbat.font.family</parameter> so it falls
  88. back to <tag>symbol</tag> font if glyph not found, like other font properties.</phrase></screen>
  89. </listitem>
  90. <listitem>
  91. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Change last instance of inline.charseq in inline <tag>glossterm</tag> to
  92. inline.italicseq so it is consistent with the others.</phrase></screen>
  93. </listitem>
  94. <listitem>
  95. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  96. </listitem>
  97. </itemizedlist>
  98. </sect2><sect2 xml:id="V1.78.1_HTML">
  99. <title>HTML</title>
  100. <para>The following changes have been made to the
  101. <filename>html</filename> code
  102. since the 1.78.0 release.</para>
  103. <itemizedlist>
  104. <listitem>
  105. <para><literal>Robert Stayton: admon.xsl</literal></para><screen><phrase role="commit-message">Turn off $admon.style if $make.clean.html is set to non-zero.</phrase></screen>
  106. </listitem>
  107. <listitem>
  108. <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Added new definitions for syntax highlighting</phrase></screen>
  109. </listitem>
  110. <listitem>
  111. <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Make active.olink.hrefs param work for chunked output too.</phrase></screen>
  112. </listitem>
  113. <listitem>
  114. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  115. </listitem>
  116. <listitem>
  117. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Add round() <tag>function</tag> when pixel counts are used for image width and height.</phrase></screen>
  118. </listitem>
  119. <listitem>
  120. <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">fix missing class and id attributes on <tag>glossterm</tag> and <tag>glossdef</tag>.</phrase></screen>
  121. </listitem>
  122. <listitem>
  123. <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fix bug where prefer.index.titleabbrev ignored <tag>info</tag>/<tag>titleabbrev</tag>.</phrase></screen>
  124. </listitem>
  125. </itemizedlist>
  126. </sect2><sect2 xml:id="V1.78.1_Manpages">
  127. <title>Manpages</title>
  128. <para>The following changes have been made to the
  129. <filename>manpages</filename> code
  130. since the 1.78.0 release.</para>
  131. <itemizedlist>
  132. <listitem>
  133. <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3599520: spurious newline in <tag>para</tag> when starts with
  134. whitespace and inline element.</phrase></screen>
  135. </listitem>
  136. </itemizedlist>
  137. </sect2><sect2 xml:id="V1.78.1_Webhelp">
  138. <title>Webhelp</title>
  139. <para>The following changes have been made to the
  140. <filename>webhelp</filename> code
  141. since the 1.78.0 release.</para>
  142. <itemizedlist>
  143. <listitem>
  144. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix test for <parameter>webhelp.include.search.tab</parameter> param</phrase></screen>
  145. </listitem>
  146. <listitem>
  147. <para><literal>David Cramer: Makefile.sample</literal></para><screen><phrase role="commit-message">Webhelp: Fix order of args to xsltproc</phrase></screen>
  148. </listitem>
  149. <listitem>
  150. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Turn on xinclude-test.xml in readme to demo xinclude functionality</phrase></screen>
  151. </listitem>
  152. <listitem>
  153. <para><literal>David Cramer: Makefile; Makefile.sample</literal></para><screen><phrase role="commit-message">Webhelp: In Makefiles, do xinclude in first pass at document</phrase></screen>
  154. </listitem>
  155. </itemizedlist>
  156. </sect2><sect2 xml:id="V1.78.1_Params">
  157. <title>Params</title>
  158. <para>The following changes have been made to the
  159. <filename>params</filename> code
  160. since the 1.78.0 release.</para>
  161. <itemizedlist>
  162. <listitem>
  163. <para><literal>David Cramer: webhelp.include.search.tab.xml</literal></para><screen><phrase role="commit-message">Webhelp: Fix test for <parameter>webhelp.include.search.tab</parameter> param</phrase></screen>
  164. </listitem>
  165. <listitem>
  166. <para><literal>Robert Stayton: article.appendix.title.properties.xml</literal></para><screen><phrase role="commit-message">Remove unneeded margin-left property from <tag>article</tag> <tag>appendix</tag> <tag>title</tag>.
  167. It interferes with the start-indent property.</phrase></screen>
  168. </listitem>
  169. </itemizedlist>
  170. </sect2><sect2 xml:id="V1.78.1_Highlighting">
  171. <title>Highlighting</title>
  172. <para>The following changes have been made to the
  173. <filename>highlighting</filename> code
  174. since the 1.78.0 release.</para>
  175. <itemizedlist>
  176. <listitem>
  177. <para><literal>Jirka Kosek: c-hl.xml; cpp-hl.xml; sql2003-hl.xml; php-hl.xml; upc-hl.xml; bourne-hl.xml; &#x22EF;</literal></para><screen><phrase role="commit-message">Added new definitions for syntax highlighting</phrase></screen>
  178. </listitem>
  179. </itemizedlist>
  180. </sect2>
  181. </sect1>
  182. <sect1 xml:id="V1.78.1">
  183. <title>Release Notes: 1.78.1</title>
  184. <para>The following is a list of changes that have been made
  185. since the 1.78.0 release.</para>
  186. <sect2 xml:id="V1.78.1_Common">
  187. <title>Common</title>
  188. <para>The following changes have been made to the
  189. <filename>common</filename> code
  190. since the 1.78.0 release.</para>
  191. <itemizedlist>
  192. <listitem>
  193. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Make sure part and set <tag>titleabbrev</tag> are used in mode="titleabbrev.markup"</phrase></screen>
  194. </listitem>
  195. <listitem>
  196. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add empty default template for <tag>titleabbrev</tag> since it is always processed in a mode.</phrase></screen>
  197. </listitem>
  198. <listitem>
  199. <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  200. </listitem>
  201. <listitem>
  202. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">for missing <tag>title</tag> in <tag>xref</tag>, provide parent information of target to help locate problem element.
  203. Process <tag>bridgehead</tag> in mode="title.markup", not normal mode.</phrase></screen>
  204. </listitem>
  205. <listitem>
  206. <para><literal>Jirka Kosek: l10n.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #3598963</phrase></screen>
  207. </listitem>
  208. <listitem>
  209. <para><literal>Robert Stayton: gentext.xsl; labels.xsl</literal></para><screen><phrase role="commit-message">Make sure bridgeheads are not numbered in all contexts, including html <tag>title</tag> attributes.</phrase></screen>
  210. </listitem>
  211. </itemizedlist>
  212. </sect2><!--end of Common changes for 1.78.1-->
  213. <sect2 xml:id="V1.78.1_FO">
  214. <title>FO</title>
  215. <para>The following changes have been made to the
  216. <filename>fo</filename> code
  217. since the 1.78.0 release.</para>
  218. <itemizedlist>
  219. <listitem>
  220. <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Fix bug where part <tag>TOC</tag> not generated when <tag>partintro</tag> is present.</phrase></screen>
  221. </listitem>
  222. <listitem>
  223. <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">Footnotes can't be placed into fo:float</phrase></screen>
  224. </listitem>
  225. <listitem>
  226. <para><literal>Robert Stayton: titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Remove margin-left when start-indent is used because they interfere
  227. with each other.</phrase></screen>
  228. </listitem>
  229. <listitem>
  230. <para><literal>Robert Stayton: fo.xsl; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Use dingbat.fontset rather than <parameter>dingbat.font.family</parameter> so it falls
  231. back to <tag>symbol</tag> font if glyph not found, like other font properties.</phrase></screen>
  232. </listitem>
  233. <listitem>
  234. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Change last instance of inline.charseq in inline <tag>glossterm</tag> to
  235. inline.italicseq so it is consistent with the others.</phrase></screen>
  236. </listitem>
  237. <listitem>
  238. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  239. </listitem>
  240. </itemizedlist>
  241. </sect2><!--end of FO changes for 1.78.1-->
  242. <sect2 xml:id="V1.78.1_HTML">
  243. <title>HTML</title>
  244. <para>The following changes have been made to the
  245. <filename>html</filename> code
  246. since the 1.78.0 release.</para>
  247. <itemizedlist>
  248. <listitem>
  249. <para><literal>Robert Stayton: admon.xsl</literal></para><screen><phrase role="commit-message">Turn off $admon.style if $make.clean.html is set to non-zero.</phrase></screen>
  250. </listitem>
  251. <listitem>
  252. <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Added new definitions for syntax highlighting</phrase></screen>
  253. </listitem>
  254. <listitem>
  255. <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Make active.olink.hrefs param work for chunked output too.</phrase></screen>
  256. </listitem>
  257. <listitem>
  258. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  259. </listitem>
  260. <listitem>
  261. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Add round() <tag>function</tag> when pixel counts are used for image width and height.</phrase></screen>
  262. </listitem>
  263. <listitem>
  264. <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">fix missing class and id attributes on <tag>glossterm</tag> and <tag>glossdef</tag>.</phrase></screen>
  265. </listitem>
  266. <listitem>
  267. <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fix bug where prefer.index.titleabbrev ignored <tag>info</tag>/<tag>titleabbrev</tag>.</phrase></screen>
  268. </listitem>
  269. </itemizedlist>
  270. </sect2><!--end of HTML changes for 1.78.1-->
  271. <sect2 xml:id="V1.78.1_Manpages">
  272. <title>Manpages</title>
  273. <para>The following changes have been made to the
  274. <filename>manpages</filename> code
  275. since the 1.78.0 release.</para>
  276. <itemizedlist>
  277. <listitem>
  278. <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3599520: spurious newline in <tag>para</tag> when starts with
  279. whitespace and inline element.</phrase></screen>
  280. </listitem>
  281. </itemizedlist>
  282. </sect2><!--end of Manpages changes for 1.78.1-->
  283. <sect2 xml:id="V1.78.1_Webhelp">
  284. <title>Webhelp</title>
  285. <para>The following changes have been made to the
  286. <filename>webhelp</filename> code
  287. since the 1.78.0 release.</para>
  288. <itemizedlist>
  289. <listitem>
  290. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix test for <parameter>webhelp.include.search.tab</parameter> param</phrase></screen>
  291. </listitem>
  292. <listitem>
  293. <para><literal>David Cramer: Makefile.sample</literal></para><screen><phrase role="commit-message">Webhelp: Fix order of args to xsltproc</phrase></screen>
  294. </listitem>
  295. <listitem>
  296. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Turn on xinclude-test.xml in readme to demo xinclude functionality</phrase></screen>
  297. </listitem>
  298. <listitem>
  299. <para><literal>David Cramer: Makefile; Makefile.sample</literal></para><screen><phrase role="commit-message">Webhelp: In Makefiles, do xinclude in first pass at document</phrase></screen>
  300. </listitem>
  301. </itemizedlist>
  302. </sect2><!--end of Webhelp changes for 1.78.1-->
  303. <sect2 xml:id="V1.78.1_Params">
  304. <title>Params</title>
  305. <para>The following changes have been made to the
  306. <filename>params</filename> code
  307. since the 1.78.0 release.</para>
  308. <itemizedlist>
  309. <listitem>
  310. <para><literal>David Cramer: webhelp.include.search.tab.xml</literal></para><screen><phrase role="commit-message">Webhelp: Fix test for <parameter>webhelp.include.search.tab</parameter> param</phrase></screen>
  311. </listitem>
  312. <listitem>
  313. <para><literal>Robert Stayton: article.appendix.title.properties.xml</literal></para><screen><phrase role="commit-message">Remove unneeded margin-left property from <tag>article</tag> <tag>appendix</tag> <tag>title</tag>.
  314. It interferes with the start-indent property.</phrase></screen>
  315. </listitem>
  316. </itemizedlist>
  317. </sect2><!--end of Params changes for 1.78.1-->
  318. <sect2 xml:id="V1.78.1_Highlighting">
  319. <title>Highlighting</title>
  320. <para>The following changes have been made to the
  321. <filename>highlighting</filename> code
  322. since the 1.78.0 release.</para>
  323. <itemizedlist>
  324. <listitem>
  325. <para><literal>Jirka Kosek: c-hl.xml; cpp-hl.xml; sql2003-hl.xml; php-hl.xml; upc-hl.xml; bourne-hl.xml; &#x22EF;</literal></para><screen><phrase role="commit-message">Added new definitions for syntax highlighting</phrase></screen>
  326. </listitem>
  327. </itemizedlist>
  328. </sect2><!--end of Highlighting changes for 1.78.1-->
  329. </sect1>
  330. <sect1 xml:id="V1.78.0">
  331. <title>Release Notes: 1.78.0</title>
  332. <para>The following is a list of changes that have been made
  333. since the 1.77.1 release.</para>
  334. <sect2 xml:id="V1.78.0_Gentext">
  335. <title>Gentext</title>
  336. <para>The following changes have been made to the
  337. <filename>gentext</filename> code
  338. since the 1.77.1 release.</para>
  339. <itemizedlist>
  340. <listitem>
  341. <para><literal>Mauritz Jeanson: locale/nn.xml; locale/nb.xml</literal></para><screen><phrase role="commit-message">Bug #3556630: Updated nb and nn locale files.</phrase></screen>
  342. </listitem>
  343. <listitem>
  344. <para><literal>Mauritz Jeanson: locale/README</literal></para><screen><phrase role="commit-message">Bug #3556628: Updated information in README.</phrase></screen>
  345. </listitem>
  346. <listitem>
  347. <para><literal>tom_schr: locale/de.xml</literal></para><screen><phrase role="commit-message">Added <tag>keycap</tag> context from RFE#3540451 to support @function attribute</phrase></screen>
  348. </listitem>
  349. <listitem>
  350. <para><literal>tom_schr: locale/en.xml</literal></para><screen><phrase role="commit-message">Added <tag>keycap</tag> context from RFE#3540451 to support @function attribute</phrase></screen>
  351. </listitem>
  352. <listitem>
  353. <para><literal>Robert Stayton: locale/en.xml</literal></para><screen><phrase role="commit-message">Add support for <tag>title</tag> element in <tag>screenshot</tag>, now allowed in DocBook 5.</phrase></screen>
  354. </listitem>
  355. </itemizedlist>
  356. </sect2><!--end of Gentext changes for 1.78.0-->
  357. <sect2 xml:id="V1.78.0_Common">
  358. <title>Common</title>
  359. <para>The following changes have been made to the
  360. <filename>common</filename> code
  361. since the 1.77.1 release.</para>
  362. <itemizedlist>
  363. <listitem>
  364. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Corrected template for <tag>bridgehead</tag> in mode="title.markup" to
  365. process its children in normal mode.</phrase></screen>
  366. </listitem>
  367. <listitem>
  368. <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Convert hard wired xsl:number for <tag>production</tag> into a template
  369. with mode="label.markup" to be consistent with other element numbering.</phrase></screen>
  370. </listitem>
  371. <listitem>
  372. <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Remove all references and code for obsolete <tag>olink</tag> attributes
  373. @linkmode @targetdocent and @localinfo.</phrase></screen>
  374. </listitem>
  375. <listitem>
  376. <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
  377. external olinks inactive, as for epub output.</phrase></screen>
  378. </listitem>
  379. </itemizedlist>
  380. </sect2><!--end of Common changes for 1.78.0-->
  381. <sect2 xml:id="V1.78.0_FO">
  382. <title>FO</title>
  383. <para>The following changes have been made to the
  384. <filename>fo</filename> code
  385. since the 1.77.1 release.</para>
  386. <itemizedlist>
  387. <listitem>
  388. <para><literal>Robert Stayton: pagesetup.xsl</literal></para><screen><phrase role="commit-message">Change initial page number for <tag>book</tag> from 1 to auto so front
  389. <tag>cover</tag> and <tag>title</tag> pages are sequential, and so that <tag>book</tag> inside
  390. set will continue numbering.</phrase></screen>
  391. </listitem>
  392. <listitem>
  393. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add missing closing <tag>tag</tag> for xsl:choose in new template.</phrase></screen>
  394. </listitem>
  395. <listitem>
  396. <para><literal>Robert Stayton: param.xweb; param.ent; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>force.blank.pages</parameter> parameter to allow turning off blank
  397. pages in <parameter>double.sided</parameter> output.</phrase></screen>
  398. </listitem>
  399. <listitem>
  400. <para><literal>Robert Stayton: lists.xsl; callout.xsl</literal></para><screen><phrase role="commit-message">Implement active links between <tag>co</tag> and <tag>callout</tag> elements for
  401. PDF output, linking in both directions.</phrase></screen>
  402. </listitem>
  403. <listitem>
  404. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix typo to replace "ro" with "<tag>row</tag>" in three places.</phrase></screen>
  405. </listitem>
  406. <listitem>
  407. <para><literal>Robert Stayton: ebnf.xsl</literal></para><screen><phrase role="commit-message">Convert hard wired xsl:number for <tag>production</tag> into a template
  408. with mode="label.markup" to be consistent with other element numbering.</phrase></screen>
  409. </listitem>
  410. <listitem>
  411. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Make comma inserted after <tag>function</tag>/parameter or <tag>function</tag>/<tag>replaceable</tag>
  412. conditional on $function.parens to be consistent with the <tag>function</tag> template.</phrase></screen>
  413. </listitem>
  414. <listitem>
  415. <para><literal>tom_schr: inline.xsl</literal></para><screen><phrase role="commit-message">Added new inline.sansseq template for consistency reasons.
  416. Makes it easier for customization layers: Just use
  417. &lt;xsl:call-template name="inline.sansseq"/&gt;
  418. to change to sans serif font, but also takes into account
  419. XLinks and direction of text.</phrase></screen>
  420. </listitem>
  421. <listitem>
  422. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Remove all references and code for obsolete <tag>olink</tag> attributes
  423. @linkmode @targetdocent and @localinfo.</phrase></screen>
  424. </listitem>
  425. <listitem>
  426. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Remove <parameter>passivetex.extensions</parameter> code.</phrase></screen>
  427. </listitem>
  428. <listitem>
  429. <para><literal>Robert Stayton: spaces.xsl; autotoc.xsl; docbook.xsl; division.xsl; table.xsl; sections.xs&#x22EF;</literal></para><screen><phrase role="commit-message">Remove all passivetex code because it is obsolete.</phrase></screen>
  430. </listitem>
  431. <listitem>
  432. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
  433. external olinks inactive, as for epub output.</phrase></screen>
  434. </listitem>
  435. <listitem>
  436. <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Added support for keep-together PI on <tag>informaltable</tag>. Closes bug #3555609.</phrase></screen>
  437. </listitem>
  438. <listitem>
  439. <para><literal>tom_schr: verbatim.xsl</literal></para><screen><phrase role="commit-message">Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing</phrase></screen>
  440. </listitem>
  441. <listitem>
  442. <para><literal>tom_schr: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fixed typo: fole -&gt; role attribute for <tag>phrase</tag></phrase></screen>
  443. </listitem>
  444. <listitem>
  445. <para><literal>tom_schr: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @function attribute in <tag>keycap</tag> (uses <tag>keycap</tag> context
  446. from language files) =&gt; fixes RFE#3540451
  447. If @function is set and <tag>keycap</tag> is empty, then template will use the
  448. content from the <tag>keycap</tag> context, otherwise it will use just the given
  449. text</phrase></screen>
  450. </listitem>
  451. <listitem>
  452. <para><literal>Robert Stayton: graphics.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>title</tag> element in <tag>screenshot</tag>, now allowed in DocBook 5.</phrase></screen>
  453. </listitem>
  454. <listitem>
  455. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Restore formatting of <tag>figure</tag>/<tag>caption</tag> that was broken in 1.77.1.</phrase></screen>
  456. </listitem>
  457. </itemizedlist>
  458. </sect2><!--end of FO changes for 1.78.0-->
  459. <sect2 xml:id="V1.78.0_HTML">
  460. <title>HTML</title>
  461. <para>The following changes have been made to the
  462. <filename>html</filename> code
  463. since the 1.77.1 release.</para>
  464. <itemizedlist>
  465. <listitem>
  466. <para><literal>David Cramer: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fixing bug where toc.title.p and nodes params had not been declared inside manual-toc template</phrase></screen>
  467. </listitem>
  468. <listitem>
  469. <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Add 'toc.list.attributes' template to insert class and other
  470. attributes on the top level list element in a <tag>table</tag> of contents.</phrase></screen>
  471. </listitem>
  472. <listitem>
  473. <para><literal>Robert Stayton: block.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3590039 <tag>abstract</tag>/<tag>title</tag> not rendered.</phrase></screen>
  474. </listitem>
  475. <listitem>
  476. <para><literal>Jirka Kosek: chunk-common.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Fixed positioning of <tag>footnote</tag> separate when CSS decoration is used.</phrase></screen>
  477. </listitem>
  478. <listitem>
  479. <para><literal>Robert Stayton: ebnf.xsl</literal></para><screen><phrase role="commit-message">Convert hard wired xsl:number for <tag>production</tag> into a template
  480. with mode="label.markup" to be consistent with other element numbering.</phrase></screen>
  481. </listitem>
  482. <listitem>
  483. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Make comma inserted after <tag>function</tag>/parameter or <tag>function</tag>/<tag>replaceable</tag>
  484. conditional on $function.parens to be consistent with the <tag>function</tag> template.</phrase></screen>
  485. </listitem>
  486. <listitem>
  487. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>mediaobject</tag>/<tag>alt</tag>, with precedence over
  488. <tag>mediaobject</tag>/<tag>textobject</tag>/<tag>phrase</tag>.</phrase></screen>
  489. </listitem>
  490. <listitem>
  491. <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Remove src:fragref elements for deleted obsolete <tag>olink</tag> params.</phrase></screen>
  492. </listitem>
  493. <listitem>
  494. <para><literal>Robert Stayton: chunker.xsl</literal></para><screen><phrase role="commit-message">Fix bug #3563697 where template make-relative-filename was using a
  495. global param chunk.base.dir instead of its local param <parameter>base.dir</parameter>. Now it uses <parameter>base.dir</parameter>.</phrase></screen>
  496. </listitem>
  497. <listitem>
  498. <para><literal>Robert Stayton: param.xweb; param.ent; xref.xsl</literal></para><screen><phrase role="commit-message">Remove all references and code for obsolete <tag>olink</tag> attributes
  499. @linkmode @targetdocent and @localinfo.</phrase></screen>
  500. </listitem>
  501. <listitem>
  502. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
  503. external olinks inactive, as for epub output.</phrase></screen>
  504. </listitem>
  505. <listitem>
  506. <para><literal>stefan: graphics.xsl</literal></para><screen><phrase role="commit-message">Add hook for customization.</phrase></screen>
  507. </listitem>
  508. <listitem>
  509. <para><literal>tom_schr: docbook.xsl</literal></para><screen><phrase role="commit-message">Splitting head.content into smaller chunks of templates.
  510. See https://lists.oasis-open.org/archives/docbook-apps/201209/msg00037.html</phrase></screen>
  511. </listitem>
  512. <listitem>
  513. <para><literal>tom_schr: verbatim.xsl</literal></para><screen><phrase role="commit-message">Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing</phrase></screen>
  514. </listitem>
  515. <listitem>
  516. <para><literal>Robert Stayton: footnote.xsl</literal></para><screen><phrase role="commit-message">Fix bug in <tag>footnote</tag> <tag>link</tag> introduced in 1.77.1.</phrase></screen>
  517. </listitem>
  518. <listitem>
  519. <para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Resolve conflict of duplicate ids on html <tag>table</tag> with <tag>caption</tag>.
  520. Wrap a div with class and id attribute around html <tag>table</tag> without <tag>caption</tag>.</phrase></screen>
  521. </listitem>
  522. <listitem>
  523. <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Remove call to 'generate.id' template in &lt;h1&gt; in component.title because the
  524. id is already generated for the parent div element.</phrase></screen>
  525. </listitem>
  526. <listitem>
  527. <para><literal>Robert Stayton: chunker.xsl</literal></para><screen><phrase role="commit-message">Set omit-xml-declaration to 'yes' for write.text.chunk template, since a text
  528. file should never have an xml declaration.</phrase></screen>
  529. </listitem>
  530. <listitem>
  531. <para><literal>tom_schr: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @function attribute in <tag>keycap</tag> (uses <tag>keycap</tag> context
  532. from language files) =&gt; fixes RFE#3540451
  533. If @function is set and <tag>keycap</tag> is empty, then template will use the
  534. content from the <tag>keycap</tag> context, otherwise it will use just the given
  535. text</phrase></screen>
  536. </listitem>
  537. <listitem>
  538. <para><literal>David Cramer: docbook.xsl</literal></para><screen><phrase role="commit-message">Also set the <tag>title</tag> param in head.content since it's sometimes
  539. called without that param being passed in. Use the passed-in
  540. value in user.head.title.</phrase></screen>
  541. </listitem>
  542. <listitem>
  543. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Restore missing <tag>title</tag> param on 'head.content' template, and passed
  544. it along to user.head.title. That param
  545. is used for certain special chunkings such as Long Descriptions.</phrase></screen>
  546. </listitem>
  547. <listitem>
  548. <para><literal>Robert Stayton: graphics.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>title</tag> in <tag>screenshot</tag>, available since DocBook 5.</phrase></screen>
  549. </listitem>
  550. <listitem>
  551. <para><literal>David Cramer: docbook.xsl</literal></para><screen><phrase role="commit-message">HTML: Add hook for easily customizing html/head/<tag>title</tag></phrase></screen>
  552. </listitem>
  553. </itemizedlist>
  554. </sect2><!--end of HTML changes for 1.78.0-->
  555. <sect2 xml:id="V1.78.0_Manpages">
  556. <title>Manpages</title>
  557. <para>The following changes have been made to the
  558. <filename>manpages</filename> code
  559. since the 1.77.1 release.</para>
  560. <itemizedlist>
  561. <listitem>
  562. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add a line break at start of <tag>variablelist</tag> to fix bug #3595156.</phrase></screen>
  563. </listitem>
  564. <listitem>
  565. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Better fix for bug #3545150 by putting the <tag>title</tag> with the step number
  566. rather than before it.</phrase></screen>
  567. </listitem>
  568. <listitem>
  569. <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Add 'content' param to template name inline.monoseq to support
  570. <tag>email</tag> format, fixing bug #3524417.</phrase></screen>
  571. </listitem>
  572. <listitem>
  573. <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Fix bug #3512473 where an inline <tag>synopsis</tag> element produced
  574. an extra line break in nroff output.</phrase></screen>
  575. </listitem>
  576. <listitem>
  577. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3545150 where <tag>procedure</tag>/step/<tag>title</tag> not rendered in man pages.</phrase></screen>
  578. </listitem>
  579. </itemizedlist>
  580. </sect2><!--end of Manpages changes for 1.78.0-->
  581. <sect2 xml:id="V1.78.0_Roundtrip">
  582. <title>Roundtrip</title>
  583. <para>The following changes have been made to the
  584. <filename>roundtrip</filename> code
  585. since the 1.77.1 release.</para>
  586. <itemizedlist>
  587. <listitem>
  588. <para><literal>Robert Stayton: dbk2wordml.xsl</literal></para><screen><phrase role="commit-message">Fix bug #3297553 error in Word metadata elements from including
  589. WordML markup instead of just text.</phrase></screen>
  590. </listitem>
  591. </itemizedlist>
  592. </sect2><!--end of Roundtrip changes for 1.78.0-->
  593. <sect2 xml:id="V1.78.0_Slides">
  594. <title>Slides</title>
  595. <para>The following changes have been made to the
  596. <filename>slides</filename> code
  597. since the 1.77.1 release.</para>
  598. <itemizedlist>
  599. <listitem>
  600. <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Use real push-style processing in the foil/foilgroup page content, which
  601. allows better customization in general (e.g. you can add PI templates)
  602. and also let us render scattered speakernotes/handoutnotes if that is
  603. desired</phrase></screen>
  604. </listitem>
  605. <listitem>
  606. <para><literal>gaborkovesdan: xhtml/Makefile</literal></para><screen><phrase role="commit-message">- Titlepage markup belongs to the XHTML namespace</phrase></screen>
  607. </listitem>
  608. <listitem>
  609. <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Remove now unnecessary template redefinition</phrase></screen>
  610. </listitem>
  611. <listitem>
  612. <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Generate valid links from cross-references</phrase></screen>
  613. </listitem>
  614. <listitem>
  615. <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Do not add fallbacks for EXSLT extensions, the main DocBook XSL stylesheets
  616. do not do that either</phrase></screen>
  617. </listitem>
  618. <listitem>
  619. <para><literal>Robert Stayton: schema/relaxng/slides.rnc</literal></para><screen><phrase role="commit-message">Update the import path for docbook.rnc after the slides directory was moved.</phrase></screen>
  620. </listitem>
  621. <listitem>
  622. <para><literal>stefan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">Add missing stylesheet.</phrase></screen>
  623. </listitem>
  624. <listitem>
  625. <para><literal>stefan: schema/xsd/Makefile; schema/Makefile; schema/relaxng/Makefile</literal></para><screen><phrase role="commit-message">Adjust Makefiles.</phrase></screen>
  626. </listitem>
  627. <listitem>
  628. <para><literal>stefan: locatingrules.xml; RELEASE-NOTES.xml; doc; images; locatingrules.xml; Makefile; im&#x22EF;</literal></para><screen><phrase role="commit-message">Moved many files from slides/ to xsl/slides/</phrase></screen>
  629. </listitem>
  630. <listitem>
  631. <para><literal>stefan: fo/param.xweb; xhtml/Makefile; xhtml/param.xweb; fo/Makefile</literal></para><screen><phrase role="commit-message">Separate slides package.</phrase></screen>
  632. </listitem>
  633. <listitem>
  634. <para><literal>stefan: Makefile</literal></para><screen><phrase role="commit-message">A bit of cleanup...</phrase></screen>
  635. </listitem>
  636. <listitem>
  637. <para><literal>stefan: xhtml/Makefile; fo/Makefile</literal></para><screen><phrase role="commit-message">Add to 'clean' target.</phrase></screen>
  638. </listitem>
  639. <listitem>
  640. <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Slides: Change html to xhtml passim.</phrase></screen>
  641. </listitem>
  642. <listitem>
  643. <para><literal>David Cramer: xhtml</literal></para><screen><phrase role="commit-message">Adding items to svn ignore for slides</phrase></screen>
  644. </listitem>
  645. <listitem>
  646. <para><literal>stefan: slidy</literal></para><screen><phrase role="commit-message">Import slidy from vendor branch.</phrase></screen>
  647. </listitem>
  648. <listitem>
  649. <para><literal>stefan: s5</literal></para><screen><phrase role="commit-message">Import s5 from vendor branch.</phrase></screen>
  650. </listitem>
  651. <listitem>
  652. <para><literal>stefan: Makefile; common/common.xsl; common; fo/param.ent; graphics; xhtml/Makefile.param;&#x22EF;</literal></para><screen><phrase role="commit-message">Merge Slides GSoC project to trunk.</phrase></screen>
  653. </listitem>
  654. </itemizedlist>
  655. </sect2><!--end of Slides changes for 1.78.0-->
  656. <sect2 xml:id="V1.78.0_Webhelp">
  657. <title>Webhelp</title>
  658. <para>The following changes have been made to the
  659. <filename>webhelp</filename> code
  660. since the 1.77.1 release.</para>
  661. <itemizedlist>
  662. <listitem>
  663. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: More doc updates</phrase></screen>
  664. </listitem>
  665. <listitem>
  666. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Documentation updates.</phrase></screen>
  667. </listitem>
  668. <listitem>
  669. <para><literal>David Cramer: template/content; Makefile; Makefile.sample; build.xml; template/search</literal></para><screen><phrase role="commit-message">Webhelp: Improving sample Makefile to allow for profiling params and other params, removing content dir from template and making related adjustments in Makefile and build.xml</phrase></screen>
  670. </listitem>
  671. <listitem>
  672. <para><literal>David Cramer: Makefile.sample</literal></para><screen><phrase role="commit-message">Attempting to include sample Makefile in webhelp output dir</phrase></screen>
  673. </listitem>
  674. <listitem>
  675. <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Do not display <tag>sidebar</tag> if js is disabled in browser since it will not be functional</phrase></screen>
  676. </listitem>
  677. <listitem>
  678. <para><literal>Jirka Kosek: build.xml</literal></para><screen><phrase role="commit-message">Xerces must be on the classpath in order to XInclude work</phrase></screen>
  679. </listitem>
  680. <listitem>
  681. <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Adding generated files to various clean targets.</phrase></screen>
  682. </listitem>
  683. <listitem>
  684. <para><literal>David Cramer: build.properties</literal></para><screen><phrase role="commit-message">Webhelp: By default don't validate against dtd when using ant build</phrase></screen>
  685. </listitem>
  686. <listitem>
  687. <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Webhelp: By default only exclude ix01.html from search in Makefile</phrase></screen>
  688. </listitem>
  689. <listitem>
  690. <para><literal>David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js; template/common/jquery&#x22EF;</literal></para><screen><phrase role="commit-message">Webhelp: Reverting last commit</phrase></screen>
  691. </listitem>
  692. <listitem>
  693. <para><literal>David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js; template/common/jquery&#x22EF;</literal></para><screen><phrase role="commit-message">Webhelp: Removing two more unused jquery files</phrase></screen>
  694. </listitem>
  695. <listitem>
  696. <para><literal>David Cramer: template/common/jquery/jquery-1.4.2.min.js</literal></para><screen><phrase role="commit-message">Webhelp: Removing old, unused jquery file</phrase></screen>
  697. </listitem>
  698. <listitem>
  699. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix header logo <tag>link</tag></phrase></screen>
  700. </listitem>
  701. <listitem>
  702. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix bad <tag>link</tag> to favicon.ico</phrase></screen>
  703. </listitem>
  704. <listitem>
  705. <para><literal>David Cramer: template/common/jquery/jquery-1.7.2.min.js; template/common/main.js; templat&#x22EF;</literal></para><screen><phrase role="commit-message">First part of the GSoC 2012 work by Arun and Visitha:
  706. Visitha Baddegama
  707. Remove content folder from Webhelp output
  708. Build Webhelp using GNU Make/without ant
  709. Support a parameterized list of files to exclude while indexing
  710. Improve information message for browser with JavaScript disabled
  711. Support searching for terms with punctuation like build.xml
  712. Arun Bharadwaj
  713. Make it possible to include the doc <tag>title</tag> in head/<tag>title</tag> and
  714. not in the search results
  715. Improve performance in IE 8/9
  716. Expandable <tag>TOC</tag> pane
  717. Information message for browser with JavaScript disabled</phrase></screen>
  718. </listitem>
  719. <listitem>
  720. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Use user.head.title to add <tag>title</tag> to webhelp pages,
  721. but do not yet add the <tag>book</tag> <tag>title</tag> to the page <tag>title</tag>.</phrase></screen>
  722. </listitem>
  723. <listitem>
  724. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Revert 9433. We need to fix the indexer before we can include the document <tag>title</tag> in the html/head/<tag>title</tag></phrase></screen>
  725. </listitem>
  726. <listitem>
  727. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Append document <tag>title</tag> to html/head/title</phrase></screen>
  728. </listitem>
  729. <listitem>
  730. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: fix missing <tag>reference</tag> to ie.css</phrase></screen>
  731. </listitem>
  732. </itemizedlist>
  733. </sect2><!--end of Webhelp changes for 1.78.0-->
  734. <sect2 xml:id="V1.78.0_Params">
  735. <title>Params</title>
  736. <para>The following changes have been made to the
  737. <filename>params</filename> code
  738. since the 1.77.1 release.</para>
  739. <itemizedlist>
  740. <listitem>
  741. <para><literal>Robert Stayton: page.height.portrait.xml; page.width.portrait.xml</literal></para><screen><phrase role="commit-message">Add USlegal and USlegallandscape.</phrase></screen>
  742. </listitem>
  743. <listitem>
  744. <para><literal>Robert Stayton: force.blank.pages.xml</literal></para><screen><phrase role="commit-message">Improve the description.</phrase></screen>
  745. </listitem>
  746. <listitem>
  747. <para><literal>Robert Stayton: page.margin.outer.xml; writing.mode.xml; double.sided.xml; page.margin.inn&#x22EF;</literal></para><screen><phrase role="commit-message">Improve the description.</phrase></screen>
  748. </listitem>
  749. <listitem>
  750. <para><literal>Robert Stayton: force.blank.pages.xml</literal></para><screen><phrase role="commit-message">New param to control generating blank even-numbered pages.</phrase></screen>
  751. </listitem>
  752. <listitem>
  753. <para><literal>Robert Stayton: passivetex.extensions.xml</literal></para><screen><phrase role="commit-message">Indicate that passivetex is no longer supported.</phrase></screen>
  754. </listitem>
  755. <listitem>
  756. <para><literal>Robert Stayton: footnote.properties.xml</literal></para><screen><phrase role="commit-message">Fix bug #3555628 where a <tag>footnote</tag> inside a <tag>blockquote</tag> inherits the end-indent from the <tag>blockquote</tag>.</phrase></screen>
  757. </listitem>
  758. <listitem>
  759. <para><literal>stefan: foil.page-sequence.properties.xml; handoutnotes.properties.xml; slidy.duration.xml&#x22EF;</literal></para><screen><phrase role="commit-message">Merge Slides GSoC project to trunk.</phrase></screen>
  760. </listitem>
  761. <listitem>
  762. <para><literal>Robert Stayton: activate.external.olinks.xml</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
  763. external olinks inactive, as for epub output.</phrase></screen>
  764. </listitem>
  765. </itemizedlist>
  766. </sect2><!--end of Params changes for 1.78.0-->
  767. <sect2 xml:id="V1.78.0_Profiling">
  768. <title>Profiling</title>
  769. <para>The following changes have been made to the
  770. <filename>profiling</filename> code
  771. since the 1.77.1 release.</para>
  772. <itemizedlist>
  773. <listitem>
  774. <para><literal>Robert Stayton: xsl2profile.xsl</literal></para><screen><phrase role="commit-message">Test for @xml:id as well as @id for $rootid.</phrase></screen>
  775. </listitem>
  776. </itemizedlist>
  777. </sect2><!--end of Profiling changes for 1.78.0-->
  778. <sect2 xml:id="V1.78.0_Tools">
  779. <title>Tools</title>
  780. <para>The following changes have been made to the
  781. <filename>tools</filename> code
  782. since the 1.77.1 release.</para>
  783. <itemizedlist>
  784. <listitem>
  785. <para><literal>David Cramer: bin/docbook-xsl-update</literal></para><screen><phrase role="commit-message">s/VERSION/VERSION.xsl/ again.</phrase></screen>
  786. </listitem>
  787. <listitem>
  788. <para><literal>David Cramer: xsl/build/xsl-param-link.xsl; xsl/build/make-xsl-params.xsl</literal></para><screen><phrase role="commit-message">Slides: Change html to xhtml passim.</phrase></screen>
  789. </listitem>
  790. </itemizedlist>
  791. </sect2><!--end of Tools changes for 1.78.0-->
  792. <sect2 xml:id="V1.78.0_Template">
  793. <title>Template</title>
  794. <para>The following changes have been made to the
  795. <filename>template</filename> code
  796. since the 1.77.1 release.</para>
  797. <itemizedlist>
  798. <listitem>
  799. <para><literal>Jirka Kosek: titlepage.xsl</literal></para><screen><phrase role="commit-message">Autoguess of proper parameter settings</phrase></screen>
  800. </listitem>
  801. </itemizedlist>
  802. </sect2><!--end of Template changes for 1.78.0-->
  803. </sect1>
  804. <sect1 xml:id="V1.77.0">
  805. <title>Release Notes: 1.77.1</title>
  806. <para>The following list summarizes the major changes that have been made
  807. since the 1.76.1 release. It is followed by sections detailing changes to individual files
  808. from the SVN checkin logs, edited to remove housekeeping changes and bug fixes.
  809. See the NEWS.xml file for a complete unedited list of SVN changes.</para>
  810. <itemizedlist>
  811. <listitem><para>Gentext</para>
  812. <variablelist><varlistentry>
  813. <term>webhelp</term>
  814. <listitem>
  815. <para>Many improvements to the generated text for webhelp output.</para>
  816. </listitem>
  817. </varlistentry></variablelist>
  818. </listitem>
  819. <listitem><para>Common</para><variablelist>
  820. <varlistentry>
  821. <term>Support more media types</term>
  822. <listitem>
  823. <para>Expanded list of supported filename extensions for media to include video and audio, mostly for HTML5 and EPUB3 outputs.</para>
  824. </listitem>
  825. </varlistentry>
  826. <varlistentry>
  827. <term>Topic element</term>
  828. <listitem>
  829. <para>Add basic support for new <literal>topic</literal> element, which is available in DocBook 5.1. Generally a topic element will be used with <literal>assembly</literal> and may be transformed to some other hierarchical element during processing, but it can also be formatted as a plain topic.</para>
  830. </listitem>
  831. </varlistentry>
  832. </variablelist></listitem>
  833. <listitem><para>FO</para><variablelist>
  834. <varlistentry>
  835. <term>Add para.properties attribute-set</term>
  836. <listitem>
  837. <para>Add a <literal>para.properties</literal> attribute-set that applies only to para elements. That allows still using <literal>normal.para.spacing</literal> attribute-set for many block elements for uniform spacing, but allows separate formatting of para elements.</para>
  838. </listitem>
  839. </varlistentry>
  840. <varlistentry>
  841. <term>List of titles in article</term>
  842. <listitem>
  843. <para>Add support for List of Tables, List of Figures, etc. for articles and other component-level elements. Includes a new template for each in <filename>autotoc.xsl</filename>, new attribute-sets in <filename>titlepage.xsl</filename>, and new entries in the <filename>titlepage.templates.xml</filename> file tu support customization.</para>
  844. </listitem>
  845. </varlistentry>
  846. <varlistentry>
  847. <term>Customizing links in FO</term>
  848. <listitem>
  849. <para>Add template mode <literal>simple.xlink.properties</literal> to allow
  850. easy customization of formatting of links generated
  851. from elements that use
  852. the xlink attributes. This extends link formatting beyond that of <literal>xref</literal>, <literal>link</literal>, and <literal>olink</literal> which use <literal>xref.properties</literal> attribute-set.</para>
  853. </listitem>
  854. </varlistentry>
  855. <varlistentry>
  856. <term>Table caption</term>
  857. <listitem>
  858. <para>The caption element in an HTML table is now handled like a title in a CALS table, using the <literal>formal.object.title</literal> template with all its features, including placement. Now <literal>caption</literal> template in <literal>mode="htmlTable"</literal> does nothing, because
  859. caption handled by <literal>formal.object.title</literal> template. Also adds support for table <literal>caption</literal> element in a CALS table, placing it after the table.</para>
  860. </listitem>
  861. </varlistentry>
  862. <varlistentry>
  863. <term>Graphics attribute handling</term>
  864. <listitem>
  865. <para>Refactored the big <literal>process.image</literal> template to use individual templates such as <literal>image.width</literal> for most attributes to allow easier customization of individual properties.</para>
  866. </listitem>
  867. </varlistentry>
  868. <varlistentry>
  869. <term>Side regions</term>
  870. <listitem>
  871. <para>Add support for side page regions in addition to header and footer regions. This feature lets you add running content to the side margins, and by default the content is rotated 90 degrees. Adds new templates named <literal>running.side.content</literal>, <literal>region.inner</literal> and <literal>region.outer</literal>; new template modes <literal><literal>region.inner.mode</literal> and <literal>region.outer.mode</literal>; </literal>new parameters named <literal>region.inner.extent</literal>, <literal>region.outer.extent</literal>, <literal>body.margin.inner</literal>, <literal>body.margin.outer</literal>, and <literal>side.region.precedence</literal>; and new attribute-sets named <literal>inner.region.content.properties</literal>, <literal>outer.region.content.properties</literal>, <literal>region.inner.properties</literal>, and <literal>region.outer.properties</literal>.</para>
  872. </listitem>
  873. </varlistentry>
  874. <varlistentry>
  875. <term>Callout formatting</term>
  876. <listitem>
  877. <para>Add new attribute-sets for <literal>calloutlist</literal>.</para>
  878. </listitem>
  879. </varlistentry>
  880. <varlistentry>
  881. <term>Topic element</term>
  882. <listitem>
  883. <para>Add basic support for formatting a topic element, which is available in DocBook 5.1.</para>
  884. </listitem>
  885. </varlistentry>
  886. </variablelist></listitem>
  887. <listitem><para>HTML</para>
  888. <variablelist><varlistentry>
  889. <term>HTML5</term>
  890. <listitem>
  891. <para>Add variables to the base HTML stylesheets that can be adjusted for the HTML5 stylesheets.</para>
  892. </listitem>
  893. </varlistentry>
  894. <varlistentry>
  895. <term>Insert Javascript reference</term>
  896. <listitem>
  897. <para>Add support for <literal>html.script</literal> param to insert reference to a Javascript file.</para>
  898. </listitem>
  899. </varlistentry>
  900. <varlistentry>
  901. <term>Namespace for titlepage mechanism.</term>
  902. <listitem>
  903. <para>Titlepage mechanism is now namespace aware to support XHTML.</para>
  904. </listitem>
  905. </varlistentry>
  906. <varlistentry>
  907. <term>Chunked filename prefix</term>
  908. <listitem>
  909. <para>New param named <literal>chunked.filename.prefix</literal> lets you add a filename prefix to each chunked file. This replaces the buggy practice of adding such a prefix to the <literal>base.dir</literal> param. Now the <literal>base.dir</literal> param will always have a trailing slash added if it is not present, so you no longer have to remember to add it to the param value.</para>
  910. </listitem>
  911. </varlistentry>
  912. <varlistentry>
  913. <term>Generate id attributes</term>
  914. <listitem>
  915. <para>The stylesheet param <literal>generate.id.attributes</literal> already existed but was incompletely implemented. Now when it is set to 1, only <literal>id</literal> attributes should be output, not <literal>&lt;a name&gt;</literal> named anchors.</para>
  916. </listitem>
  917. </varlistentry>
  918. <varlistentry>
  919. <term>Generate consistent id attributes</term>
  920. <listitem>
  921. <para>New <literal>generate.consistent.ids</literal> parameter which allows generating a more stable id values based on XPath rather than the <literal>generate-id()</literal> function, which may not produce consistent values between runs. Stable output ids allow you to make stable links to generated content from the outside.</para>
  922. </listitem>
  923. </varlistentry>
  924. <varlistentry>
  925. <term>Topic element</term>
  926. <listitem>
  927. <para>Add basic support for formatting a topic element, which is available in DocBook 5.1. Generally a topic element will be used with assembly and may be transformed to some other hierarchical element during processing, but it can also be formatted as a plain topic.</para>
  928. </listitem>
  929. </varlistentry>
  930. </variablelist>
  931. </listitem>
  932. <listitem><para>Webhelp</para>
  933. <variablelist>
  934. <varlistentry>
  935. <term>Webhelp refactored</term>
  936. <listitem>
  937. <para>Webhelp templates refactored to better support customization.</para>
  938. </listitem>
  939. </varlistentry>
  940. <varlistentry>
  941. <term>Added documentation.</term>
  942. <listitem>
  943. <para>More and better documentation added.</para>
  944. </listitem>
  945. </varlistentry>
  946. <varlistentry>
  947. <term>Webhelp generated text</term>
  948. <listitem>
  949. <para>Many improvements to the generated text for webhelp output.</para>
  950. </listitem>
  951. </varlistentry>
  952. </variablelist>
  953. </listitem>
  954. <listitem><para>XHTML5</para>
  955. <para>New stylesheets to generate HTML5 output, in an XML serialization. These templates are a customization layer on top of the XHTML stylesheet files.</para>
  956. </listitem>
  957. <listitem><para>EPUB3</para>
  958. <para>New stylesheets to generate EPUB3 output. These templates are a customization layer on top of the xhtml5 stylesheet files.</para>
  959. </listitem>
  960. <listitem><para>Assembly</para>
  961. <para>New <literal>assembly.xsl</literal> stylesheet to convert a DocBook 5.1 assembly into a standard DocBook 5 document. Also includes a <literal>topic-maker-chunk.xsl</literal> stylesheet that can convert a DocBook 5 book or article document into an assembly with a collection of modular files, including converting some elements to topic files.</para>
  962. </listitem>
  963. </itemizedlist>
  964. <sect2 xml:id="rnV1.77_Gentext">
  965. <title>Gentext</title>
  966. <para>The following changes have been made to the
  967. <filename>gentext</filename> code
  968. since the 1.76.1 release.</para>
  969. <itemizedlist>
  970. <listitem>
  971. <para><literal>stefanhinz: locale/de.xml</literal></para><screen><phrase role="commit-message">Translated German WebHelp strings</phrase></screen>
  972. </listitem>
  973. <listitem>
  974. <para><literal>David Cramer: locale/zh.xml; locale/en.xml; locale/fr.xml; locale/de.xml; locale/ja.xml</literal></para><screen><phrase role="commit-message">Webhelp: Update non-en gentext strings</phrase></screen>
  975. </listitem>
  976. <listitem>
  977. <para><literal>Robert Stayton: locale/en.xml</literal></para><screen><phrase role="commit-message">Add topic to title-numbered context.</phrase></screen>
  978. </listitem>
  979. <listitem>
  980. <para><literal>Robert Stayton: locale/en.xml</literal></para><screen><phrase role="commit-message">Add basic topic element templates.</phrase></screen>
  981. </listitem>
  982. <listitem>
  983. <para><literal>Mauritz Jeanson: locale/el.xml</literal></para><screen><phrase role="commit-message">Updated gentext for quotation marks. Fixes bug #3512440.</phrase></screen>
  984. </listitem>
  985. <listitem>
  986. <para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Adding missing context for webhelp</phrase></screen>
  987. </listitem>
  988. <listitem>
  989. <para><literal>David Cramer: locale/en.xml</literal></para><screen><phrase role="commit-message">Fixing syntax of webhelp gentext entries</phrase></screen>
  990. </listitem>
  991. <listitem>
  992. <para><literal>David Cramer: locale/en.xml</literal></para><screen><phrase role="commit-message">Moving webhelp gentext strings into a context</phrase></screen>
  993. </listitem>
  994. <listitem>
  995. <para><literal>tom_schr: locale/zh.xml; locale/en.xml; locale/cs.xml; locale/fr.xml; locale/de.xml; local&#x22EF;</literal></para><screen><phrase role="commit-message">Moved language specific of WebHelp to gentext/locale/ as discussed with
  996. Stefan following the "minimal intrusive approach". :)
  997. In the long run, maybe moving the text into a context, not sure.</phrase></screen>
  998. </listitem>
  999. <listitem>
  1000. <para><literal>Jirka Kosek: locale/ru.xml</literal></para><screen><phrase role="commit-message">Aligned capitalization of first letters with English original</phrase></screen>
  1001. </listitem>
  1002. </itemizedlist>
  1003. </sect2><!--end of Gentext changes for snapshot_-->
  1004. <sect2 xml:id="VrnV1.77_Common">
  1005. <title>Common</title>
  1006. <para>The following changes have been made to the
  1007. <filename>common</filename> code
  1008. since the 1.76.1 release.</para>
  1009. <itemizedlist>
  1010. <listitem>
  1011. <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">In "select.mediaobject.index" template, add selection of <tag>videoobject</tag>
  1012. and <tag>audioobject</tag> since now supported in HTML5.</phrase></screen>
  1013. </listitem>
  1014. <listitem>
  1015. <para><literal>Robert Stayton: labels.xsl; titles.xsl; entities.ent; targets.xsl; subtitles.xsl; gentext.&#x22EF;</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
  1016. </listitem>
  1017. <listitem>
  1018. <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.</phrase></screen>
  1019. </listitem>
  1020. <listitem>
  1021. <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Generate error message if <tag>olink</tag> data in targetset is in a namespace.</phrase></screen>
  1022. </listitem>
  1023. <listitem>
  1024. <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>generate.consistent.ids</parameter> parameter.</phrase></screen>
  1025. </listitem>
  1026. <listitem>
  1027. <para><literal>Robert Stayton: subtitles.xsl</literal></para><screen><phrase role="commit-message">Add verbose param to subtitle.markup templates to allow its
  1028. error message to be ignored.
  1029. Add that param to fop1.xsl <tag>application</tag> of subtitle.markup
  1030. to avoid unnecessary error message in document information.</phrase></screen>
  1031. </listitem>
  1032. <listitem>
  1033. <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Add empty templates for <tag>glossdiv</tag>, <tag>glosslist</tag>, and <tag>glossentry</tag> in
  1034. mode="label.markup".</phrase></screen>
  1035. </listitem>
  1036. </itemizedlist>
  1037. </sect2><!--end of Common changes for snapshot_-->
  1038. <sect2 xml:id="rnV1.77_FO">
  1039. <title>FO</title>
  1040. <para>The following changes have been made to the
  1041. <filename>fo</filename> code
  1042. since the 1.76.1 release.</para>
  1043. <itemizedlist>
  1044. <listitem>
  1045. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">qualify <tag>caption</tag> template to <tag>mediaobject</tag>/<tag>caption</tag> so not confused with <tag>table</tag>/<tag>caption</tag>.</phrase></screen>
  1046. </listitem>
  1047. <listitem>
  1048. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add template to process <tag>table</tag>/<tag>caption</tag> element.</phrase></screen>
  1049. </listitem>
  1050. <listitem>
  1051. <para><literal>Robert Stayton: titlepage.xsl; autotoc.xsl; component.xsl; xref.xsl; titlepage.templates.x&#x22EF;</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
  1052. </listitem>
  1053. <listitem>
  1054. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.</phrase></screen>
  1055. </listitem>
  1056. <listitem>
  1057. <para><literal>Robert Stayton: titlepage.xsl</literal></para><screen><phrase role="commit-message">Add default style att-sets for component.list.of.titles, etc.</phrase></screen>
  1058. </listitem>
  1059. <listitem>
  1060. <para><literal>Robert Stayton: autotoc.xsl; component.xsl; titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add make.component.tocs to support lists of tables, etc. for
  1061. <tag>article</tag> and other components. Added component.list.of.tables to
  1062. titlepage.templates.xml to format the <tag>title</tag>.</phrase></screen>
  1063. </listitem>
  1064. <listitem>
  1065. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new <parameter>para.properties</parameter> attribute-set for paragraphs.</phrase></screen>
  1066. </listitem>
  1067. <listitem>
  1068. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add template mode 'simple.xlink.properties' to allow
  1069. easy customization of formatting of links generated
  1070. from elements other than <tag>xref</tag>, <tag>link</tag>, and <tag>olink</tag> using
  1071. the xlink attributes.</phrase></screen>
  1072. </listitem>
  1073. <listitem>
  1074. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>table.caption.properties</parameter> to format <tag>table</tag> captions.</phrase></screen>
  1075. </listitem>
  1076. <listitem>
  1077. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>caption</tag> in a CALS <tag>table</tag>.</phrase></screen>
  1078. </listitem>
  1079. <listitem>
  1080. <para><literal>Robert Stayton: graphics.xsl; math.xsl</literal></para><screen><phrase role="commit-message">Refactored the 'process.image' template to create modular
  1081. templates for each attribute so they can be individually
  1082. customized. Also merged in support for embedded svg and
  1083. mml content so they can have image attributes too.</phrase></screen>
  1084. </listitem>
  1085. <listitem>
  1086. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Check in new params for FO side regions in page masters.</phrase></screen>
  1087. </listitem>
  1088. <listitem>
  1089. <para><literal>Robert Stayton: titlepage.xsl; titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add support for <tag>itermset</tag> in <tag>info</tag> elements, using titlepage mechanism
  1090. to ensure entries are placed inside page-sequence.</phrase></screen>
  1091. </listitem>
  1092. <listitem>
  1093. <para><literal>Robert Stayton: pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add support for side body margins and side static content regions.
  1094. Fixes bug 3389931.</phrase></screen>
  1095. </listitem>
  1096. <listitem>
  1097. <para><literal>Robert Stayton: param.xweb; param.ent; task.xsl</literal></para><screen><phrase role="commit-message">Add attribute-set <parameter>task.properties</parameter> to <tag>task</tag> element to
  1098. support customization.</phrase></screen>
  1099. </listitem>
  1100. <listitem>
  1101. <para><literal>Robert Stayton: lists.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new attribute-sets <parameter>calloutlist.properties</parameter> and <parameter>callout.properties</parameter>
  1102. to better support customization of calloutlists, fixing bug 3160341.</phrase></screen>
  1103. </listitem>
  1104. <listitem>
  1105. <para><literal>Jirka Kosek: Makefile</literal></para><screen><phrase role="commit-message">Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.</phrase></screen>
  1106. </listitem>
  1107. <listitem>
  1108. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Allow selection by role for multiple <tag>imageobject</tag> elements
  1109. within an <tag>imageobjectco</tag>, which since Docbook 5 allows multiple imageobjects.</phrase></screen>
  1110. </listitem>
  1111. <listitem>
  1112. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added template for collabname. Fixes bug #3414436.</phrase></screen>
  1113. </listitem>
  1114. <listitem>
  1115. <para><literal>David Cramer: verbatim.xsl</literal></para><screen><phrase role="commit-message">Support the keep-together processing-instruction on <tag>programlisting</tag>, <tag>screen</tag>, <tag>synopsis</tag>, and <tag>literallayout</tag>. Tracker id #3396906.</phrase></screen>
  1116. </listitem>
  1117. <listitem>
  1118. <para><literal>Robert Stayton: pagesetup.xsl</literal></para><screen><phrase role="commit-message">Pass the pageclass, sequence, and gentext-key to the template
  1119. named header.footer.widths to enable further customization
  1120. based on page master.</phrase></screen>
  1121. </listitem>
  1122. <listitem>
  1123. <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">hyphenation of URL content must be disabled for <tag>link</tag>, not only for ulink because od DB5</phrase></screen>
  1124. </listitem>
  1125. <listitem>
  1126. <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">URLs shouldn't be hyphenated as normal text</phrase></screen>
  1127. </listitem>
  1128. <listitem>
  1129. <para><literal>Jirka Kosek: callout.xsl</literal></para><screen><phrase role="commit-message">Added support for alternative circled numbers</phrase></screen>
  1130. </listitem>
  1131. <listitem>
  1132. <para><literal>Mauritz Jeanson: axf.xsl; fop1.xsl; xep.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>author</tag>/<tag>orgname</tag> in document metadata. Closes bug #3132862.</phrase></screen>
  1133. </listitem>
  1134. <listitem>
  1135. <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add template for <tag>article</tag>/<tag>colophon</tag> to avoid nested page-sequence.</phrase></screen>
  1136. </listitem>
  1137. </itemizedlist>
  1138. </sect2><!--end of FO changes for snapshot_-->
  1139. <sect2 xml:id="rnV1.77_HTML">
  1140. <title>HTML</title>
  1141. <para>The following changes have been made to the
  1142. <filename>html</filename> code
  1143. since the 1.76.1 release.</para>
  1144. <itemizedlist>
  1145. <listitem>
  1146. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add support for using <tag>info</tag>/<tag>title</tag> as well as <tag>title</tag> in target element.</phrase></screen>
  1147. </listitem>
  1148. <listitem>
  1149. <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Enable support for html5 features, including using &lt;<tag>section</tag>&gt; instead of
  1150. &lt;div&gt; for certain elements, and setting heading level to &lt;h1&gt; for chapters.
  1151. These features are not changed in the base html stylesheet for backwards
  1152. compatibility.</phrase></screen>
  1153. </listitem>
  1154. <listitem>
  1155. <para><literal>Robert Stayton: docbook.css.xml</literal></para><screen><phrase role="commit-message">Add style for <tag>footnote</tag> rule.</phrase></screen>
  1156. </listitem>
  1157. <listitem>
  1158. <para><literal>Robert Stayton: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>subtitle</tag> inside <tag>info</tag>.</phrase></screen>
  1159. </listitem>
  1160. <listitem>
  1161. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Add call to new 'root.attributes' placeholder template to allow
  1162. adding attributes to the &lt;html&gt; output element.</phrase></screen>
  1163. </listitem>
  1164. <listitem>
  1165. <para><literal>Robert Stayton: inline.xsl; titlepage.xsl; formal.xsl; division.xsl; toc.xsl; sections.xsl&#x22EF;</literal></para><screen><phrase role="commit-message">Finish implementation of <parameter>generate.id.attributes</parameter> for all elements
  1166. using the template named id.attribute.</phrase></screen>
  1167. </listitem>
  1168. <listitem>
  1169. <para><literal>Robert Stayton: autotoc.xsl; chunktoc.xsl; titlepage.xsl; chunk-code.xsl; changebars.xsl; &#x22EF;</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
  1170. </listitem>
  1171. <listitem>
  1172. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.</phrase></screen>
  1173. </listitem>
  1174. <listitem>
  1175. <para><literal>Robert Stayton: callout.xsl; verbatim.xsl</literal></para><screen><phrase role="commit-message">Restore <tag>programlisting</tag> to use &lt;pre&gt; instead of &lt;div&gt; and instead
  1176. wrap <tag>callout</tag> img elements in &lt;span&gt; to make valid HTML.</phrase></screen>
  1177. </listitem>
  1178. <listitem>
  1179. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Turn off img longdesc attribute because not supported by browsers.</phrase></screen>
  1180. </listitem>
  1181. <listitem>
  1182. <para><literal>Robert Stayton: footnote.xsl</literal></para><screen><phrase role="commit-message">Move square brackets and &lt;sup&gt; inside &lt;a&gt; element for <tag>footnote</tag>
  1183. marks to fix display problems in some browsers.</phrase></screen>
  1184. </listitem>
  1185. <listitem>
  1186. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new params <parameter>html.script</parameter> and <parameter>html.script.type</parameter> to support
  1187. Javascript references.</phrase></screen>
  1188. </listitem>
  1189. <listitem>
  1190. <para><literal>Robert Stayton: chunk-common.xsl; chunktoc.xsl; titlepage.xsl; chunker.xsl; chunk-code.xsl&#x22EF;</literal></para><screen><phrase role="commit-message">Add support for <parameter>chunked.filename.prefix</parameter> param.
  1191. Make sure <parameter>base.dir</parameter> value has a trailing slash in
  1192. the chunk.base.dir internal param used by the templates.</phrase></screen>
  1193. </listitem>
  1194. <listitem>
  1195. <para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Now handles <tag>caption</tag> in html markup <tag>table</tag> like <tag>title</tag>,
  1196. so formal.object.title is used with all its features, including
  1197. formatting and placement.
  1198. Added htmlTable.with.caption template to handle the wrapper, and
  1199. left htmlTable template unchanged.
  1200. Now <tag>caption</tag> template in mode="htmlTable" does nothing, because
  1201. <tag>caption</tag> handled by formal.object.title template.</phrase></screen>
  1202. </listitem>
  1203. <listitem>
  1204. <para><literal>Robert Stayton: html.xsl</literal></para><screen><phrase role="commit-message">Turn off generating the <tag>title</tag> attribute for block and hierarchical elements.
  1205. Should only be used for inline elements, usually using the <tag>alt</tag> element.
  1206. Also used for links to show the target <tag>title</tag>.</phrase></screen>
  1207. </listitem>
  1208. <listitem>
  1209. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">The spacing="compact" attribute on lists in HTML no longer outputs compact="compact"
  1210. (or just "compact" in the case of Saxon 6), since that attribute is
  1211. deprecated and improperly supported. Instead, the output uses a
  1212. multiple class attribute such as class="<tag>orderedlist</tag> compact".
  1213. Use CSS to style such lists without margin above.</phrase></screen>
  1214. </listitem>
  1215. <listitem>
  1216. <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Allow selection by role for multiple <tag>imageobject</tag> elements
  1217. within an <tag>imageobjectco</tag>, which since Docbook 5 allows multiple imageobjects.</phrase></screen>
  1218. </listitem>
  1219. <listitem>
  1220. <para><literal>Robert Stayton: pi.xsl</literal></para><screen><phrase role="commit-message">Improve doc descriptions of dbhtml <tag>filename</tag> and dir.</phrase></screen>
  1221. </listitem>
  1222. <listitem>
  1223. <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Add <tag>setindex</tag> to context param in mode="<tag>reference</tag>" to better
  1224. support <tag>setindex</tag>.</phrase></screen>
  1225. </listitem>
  1226. <listitem>
  1227. <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Support set as child of set in set.toc template.</phrase></screen>
  1228. </listitem>
  1229. <listitem>
  1230. <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Change <tag>question</tag> and <tag>title</tag> templates to replace hard-coded
  1231. class="local-name()" with mode="class.attribute" to support customization
  1232. of class values.</phrase></screen>
  1233. </listitem>
  1234. <listitem>
  1235. <para><literal>Norman Walsh: chunktoc.xsl</literal></para><screen><phrase role="commit-message">Separate <tag>book</tag> appendixes from <tag>article</tag> appendixes (so that they can be customized independently)</phrase></screen>
  1236. </listitem>
  1237. <listitem>
  1238. <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added condition to prevent "Failed to interpret image" messages (SVG is not supported
  1239. by the graphic size extension).</phrase></screen>
  1240. </listitem>
  1241. </itemizedlist>
  1242. </sect2><!--end of HTML changes for snapshot_-->
  1243. <sect2 xml:id="rnV1.77_Epub">
  1244. <title>Epub</title>
  1245. <para>The following changes have been made to the
  1246. <filename>epub</filename> code
  1247. since the 1.76.1 release.</para>
  1248. <itemizedlist>
  1249. <listitem>
  1250. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Replace $base.dir with $chunk.base.dir to ensure trailing slash in place.</phrase></screen>
  1251. </listitem>
  1252. </itemizedlist>
  1253. </sect2><!--end of Epub changes for snapshot_-->
  1254. <sect2 xml:id="rnV1.77_HTMLHelp">
  1255. <title>HTMLHelp</title>
  1256. <para>The following changes have been made to the
  1257. <filename>htmlhelp</filename> code
  1258. since the 1.76.1 release.</para>
  1259. <itemizedlist>
  1260. <listitem>
  1261. <para><literal>Robert Stayton: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Change $base.dir to $chunk.base.dir to ensure trailing slash in place.</phrase></screen>
  1262. </listitem>
  1263. </itemizedlist>
  1264. </sect2><!--end of HTMLHelp changes for snapshot_-->
  1265. <sect2 xml:id="rnV1.77_Eclipse">
  1266. <title>Eclipse</title>
  1267. <para>The following changes have been made to the
  1268. <filename>eclipse</filename> code
  1269. since the 1.76.1 release.</para>
  1270. <itemizedlist>
  1271. <listitem>
  1272. <para><literal>Robert Stayton: eclipse.xsl; eclipse3.xsl</literal></para><screen><phrase role="commit-message">Use $chunk.base.dir instead of $base.dir to ensure trailing slash is in place.</phrase></screen>
  1273. </listitem>
  1274. </itemizedlist>
  1275. </sect2><!--end of Eclipse changes for snapshot_-->
  1276. <sect2 xml:id="rnV1.77_">
  1277. <title>JavaHelp</title>
  1278. <para>The following changes have been made to the
  1279. <filename>javahelp</filename> code
  1280. since the 1.76.1 release.</para>
  1281. <itemizedlist>
  1282. <listitem>
  1283. <para><literal>Robert Stayton: javahelp.xsl</literal></para><screen><phrase role="commit-message">Change $base.dir to $chunk.base.dir to ensure trailing slash is present.</phrase></screen>
  1284. </listitem>
  1285. <listitem>
  1286. <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Replaced empty header.navigation and footer.navigation templates with parameter <parameter>suppress.navigation</parameter>=1,
  1287. which simplifies customization. See bug #3310904.</phrase></screen>
  1288. </listitem>
  1289. </itemizedlist>
  1290. </sect2><!--end of JavaHelp changes for snapshot_-->
  1291. <sect2 xml:id="rnV1.77_Webhelp">
  1292. <title>Webhelp</title>
  1293. <para>The following changes have been made to the
  1294. <filename>webhelp</filename> code
  1295. since the 1.76.1 release.</para>
  1296. <itemizedlist>
  1297. <listitem>
  1298. <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Adding print-only css rules</phrase></screen>
  1299. </listitem>
  1300. <listitem>
  1301. <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Webhelp: Arun's fix for bug where heading was partially hidden by header in some situations.</phrase></screen>
  1302. </listitem>
  1303. <listitem>
  1304. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: turn off autolabeling by default</phrase></screen>
  1305. </listitem>
  1306. <listitem>
  1307. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Import xhtml base stylesheets</phrase></screen>
  1308. </listitem>
  1309. <listitem>
  1310. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: <tag>Link</tag> to the DocBook <tag>reference</tag> docs from the webhelp readme</phrase></screen>
  1311. </listitem>
  1312. <listitem>
  1313. <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Use gentext value for noscript warning</phrase></screen>
  1314. </listitem>
  1315. <listitem>
  1316. <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Webhelp: Delete tempfile after DocBook xsl build</phrase></screen>
  1317. </listitem>
  1318. <listitem>
  1319. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: moving parameters into the standard location so they will be part of the parameter <tag>reference</tag></phrase></screen>
  1320. </listitem>
  1321. <listitem>
  1322. <para><literal>David Cramer: xsl/webhelp.xsl; xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: moving parameters into the standard location so they will be part of the parameter <tag>reference</tag></phrase></screen>
  1323. </listitem>
  1324. <listitem>
  1325. <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Webhelp: tweaking scrolldown offset for anchors</phrase></screen>
  1326. </listitem>
  1327. <listitem>
  1328. <para><literal>David Cramer: docsrc/images; docsrc/images/sample.jpg; docsrc/readme.xml; template/content&#x22EF;</literal></para><screen><phrase role="commit-message">Webhelp: updating docs. Ant version, install instructions, handling of images.</phrase></screen>
  1329. </listitem>
  1330. <listitem>
  1331. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Patch from Arun Bharadwaj to display message if JavaScript is disabled</phrase></screen>
  1332. </listitem>
  1333. <listitem>
  1334. <para><literal>David Cramer: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Patch from Arun Bharadwaj to strip quotes from search query strings</phrase></screen>
  1335. </listitem>
  1336. <listitem>
  1337. <para><literal>Robert Stayton: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
  1338. </listitem>
  1339. <listitem>
  1340. <para><literal>Jirka Kosek: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Put back old extensibility point.
  1341. Guys, please don't remove existing extensibility points like named templates, it will break existing customizations.</phrase></screen>
  1342. </listitem>
  1343. <listitem>
  1344. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Moving webhelp gentext strings into a context</phrase></screen>
  1345. </listitem>
  1346. <listitem>
  1347. <para><literal>tom_schr: param.ent</literal></para><screen><phrase role="commit-message">Disabled branding and brandname entities for the time being</phrase></screen>
  1348. </listitem>
  1349. <listitem>
  1350. <para><literal>tom_schr: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Prepared WebHelp <tag>reference</tag> documentation :)
  1351. Not clear about parameters brandname and branding: Should they renamed
  1352. to "webhelp.branding" and "webhelp.brandname"?
  1353. Currently, docsrc/reference.xml contains only a comment for the WebHelp
  1354. ref doc to be non-intrusive.
  1355. Idea is to enable it when it is ready</phrase></screen>
  1356. </listitem>
  1357. <listitem>
  1358. <para><literal>tom_schr: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Moved language specific of WebHelp to gentext/locale/ as discussed with
  1359. Stefan following the "minimal intrusive approach". :)
  1360. In the long run, maybe moving the text into a context, not sure.</phrase></screen>
  1361. </listitem>
  1362. <listitem>
  1363. <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Lower the minimum width of content pane</phrase></screen>
  1364. </listitem>
  1365. <listitem>
  1366. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/main.js</literal></para><screen><phrase role="commit-message">If an user moved to another page by clicking on a <tag>toc</tag> <tag>link</tag>, and then clicked on #searchDiv,
  1367. search should be performed if the cookie textToSearch is not empty.</phrase></screen>
  1368. </listitem>
  1369. <listitem>
  1370. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Left align titles in nav header. Display for all but the topmost page</phrase></screen>
  1371. </listitem>
  1372. <listitem>
  1373. <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js; docsrc/xinclude-test.xml</literal></para><screen><phrase role="commit-message">Webhelp: Cleanup related to en_stemmer.js changes</phrase></screen>
  1374. </listitem>
  1375. <listitem>
  1376. <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Don't put borders around <tag>qandaset</tag> list</phrase></screen>
  1377. </listitem>
  1378. <listitem>
  1379. <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Webhelp: Avoid unnecessary scroll ups when <tag>anchor</tag> is clicked on</phrase></screen>
  1380. </listitem>
  1381. <listitem>
  1382. <para><literal>David Cramer: build.properties</literal></para><screen><phrase role="commit-message">Webhelp: Show footer nav by default</phrase></screen>
  1383. </listitem>
  1384. <listitem>
  1385. <para><literal>David Cramer: build.properties; build.xml</literal></para><screen><phrase role="commit-message">Webhelp: Support setting <parameter>suppress.footer.navigation</parameter> from build.properties</phrase></screen>
  1386. </listitem>
  1387. <listitem>
  1388. <para><literal>David Cramer: build.properties; build.xml</literal></para><screen><phrase role="commit-message">Webhelp: Support <parameter>admon.graphics</parameter> param in build.properties</phrase></screen>
  1389. </listitem>
  1390. <listitem>
  1391. <para><literal>David Cramer: docsrc/xinclude-test.xml; docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Adding xinclude example to the demo/readme doc</phrase></screen>
  1392. </listitem>
  1393. <listitem>
  1394. <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Remove border around <tag>table</tag> used to format <tag>callout</tag> list</phrase></screen>
  1395. </listitem>
  1396. <listitem>
  1397. <para><literal>David Cramer: xsl/webhelp.xsl; template/common/images/admon/tip.png; template/common/image&#x22EF;</literal></para><screen><phrase role="commit-message">Webhelp: Support admon graphics (still off by default)</phrase></screen>
  1398. </listitem>
  1399. <listitem>
  1400. <para><literal>David Cramer: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Turn on navfooter and fix related css</phrase></screen>
  1401. </listitem>
  1402. <listitem>
  1403. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix error about undeclared doc.title param</phrase></screen>
  1404. </listitem>
  1405. <listitem>
  1406. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Adding some test search terms to the readme</phrase></screen>
  1407. </listitem>
  1408. <listitem>
  1409. <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js</literal></para><screen><phrase role="commit-message">Handle exceptional cases listed in the Porter 2 stemming algo</phrase></screen>
  1410. </listitem>
  1411. <listitem>
  1412. <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js</literal></para><screen><phrase role="commit-message">Webhelp: adding special case word 'say' to en js stemmer</phrase></screen>
  1413. </listitem>
  1414. <listitem>
  1415. <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js</literal></para><screen><phrase role="commit-message">Webhelp: Refine stemming of terms that end in (only stem if there's a consonant before the -y)</phrase></screen>
  1416. </listitem>
  1417. <listitem>
  1418. <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js; template/content/search/nwSe&#x22EF;</literal></para><screen><phrase role="commit-message">Webhelp: fixed bug where words like key, day, and nucleus, were not found due to differences in the way the client stemmer and indexer stemmed words</phrase></screen>
  1419. </listitem>
  1420. <listitem>
  1421. <para><literal>David Cramer: build.xml</literal></para><screen><phrase role="commit-message">Webhelp: Support xinclude and two-pass profiling in build.xml</phrase></screen>
  1422. </listitem>
  1423. <listitem>
  1424. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Fix bad <tag>link</tag> to default topic.</phrase></screen>
  1425. </listitem>
  1426. <listitem>
  1427. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Automatically limit the size of the search description to something 140 characters</phrase></screen>
  1428. </listitem>
  1429. <listitem>
  1430. <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">removing outline in 'contents' and 'search' buttons that is visible when clicked. tabindex for <tag>SIDEBAR</tag> button.</phrase></screen>
  1431. </listitem>
  1432. <listitem>
  1433. <para><literal>kasunbg: xsl/webhelp.xsl; build.xml</literal></para><screen><phrase role="commit-message">Webhelp ant script changes - HTML transformation support for WebHelp - Uses Tagsoup for parsing the bad html.
  1434. tagsoup-1.2.1.jar is added to trunk/xsl-webhelpindexer/lib/</phrase></screen>
  1435. </listitem>
  1436. <listitem>
  1437. <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">proper support for saxon xhtml transformation.</phrase></screen>
  1438. </listitem>
  1439. <listitem>
  1440. <para><literal>kasunbg: template/common/images/callouts/10.png; template/common/images/callouts/11.png; t&#x22EF;</literal></para><screen><phrase role="commit-message">webhelp - adding callouts</phrase></screen>
  1441. </listitem>
  1442. <listitem>
  1443. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/main.js; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">webhelp - animations for show/hide <tag>Sidebar</tag></phrase></screen>
  1444. </listitem>
  1445. <listitem>
  1446. <para><literal>kasunbg: build.properties</literal></para><screen><phrase role="commit-message">commenting about brand and brandname</phrase></screen>
  1447. </listitem>
  1448. <listitem>
  1449. <para><literal>kasunbg: Makefile</literal></para><screen><phrase role="commit-message">parameterized MAKE for webhelp</phrase></screen>
  1450. </listitem>
  1451. <listitem>
  1452. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; build.properties; build.xml</literal></para><screen><phrase role="commit-message">webhelp xsl customization - logo</phrase></screen>
  1453. </listitem>
  1454. <listitem>
  1455. <para><literal>kasunbg: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">remove some JS warninings</phrase></screen>
  1456. </listitem>
  1457. <listitem>
  1458. <para><literal>kasunbg: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Fix for missing "No results found for..." bug</phrase></screen>
  1459. </listitem>
  1460. <listitem>
  1461. <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">commented about the importance of the order of css contents. Order is <tag>important</tag> between the in-html-file css and the linked css files. Some css declarations in jquery-ui-1.8.2.custom.css are over-ridden. If that's a concern, just remove the additional css contents inside these default jquery css files. I thought of keeping them intact for easier maintenance.</phrase></screen>
  1462. </listitem>
  1463. <listitem>
  1464. <para><literal>Jirka Kosek: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Minor cleanup, added extensibility hook, some styling moved into CSS for easier customization</phrase></screen>
  1465. </listitem>
  1466. <listitem>
  1467. <para><literal>David Cramer: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Removing onclick that came from Oxygen's dita stuff</phrase></screen>
  1468. </listitem>
  1469. <listitem>
  1470. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">webhelp - documenting about features</phrase></screen>
  1471. </listitem>
  1472. <listitem>
  1473. <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">webhelp search text box</phrase></screen>
  1474. </listitem>
  1475. <listitem>
  1476. <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">adding header background image</phrase></screen>
  1477. </listitem>
  1478. <listitem>
  1479. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/images/header-bg.png</literal></para><screen><phrase role="commit-message">new header background image</phrase></screen>
  1480. </listitem>
  1481. <listitem>
  1482. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">fix left navigation</phrase></screen>
  1483. </listitem>
  1484. <listitem>
  1485. <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">some css</phrase></screen>
  1486. </listitem>
  1487. <listitem>
  1488. <para><literal>kasunbg: build.xml</literal></para><screen><phrase role="commit-message">Adding html.extension property</phrase></screen>
  1489. </listitem>
  1490. <listitem>
  1491. <para><literal>kasunbg: template/common/css/positioning.css; build.properties; build.xml</literal></para><screen><phrase role="commit-message">webhelp - Adding enable.stemming, toc.file build properties</phrase></screen>
  1492. </listitem>
  1493. <listitem>
  1494. <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Make the webhelp banner slightly larger.</phrase></screen>
  1495. </listitem>
  1496. <listitem>
  1497. <para><literal>David Cramer: template/common/main.js; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Adjust colors and positioning of header and search/<tag>toc</tag> tabs</phrase></screen>
  1498. </listitem>
  1499. <listitem>
  1500. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Only put doc <tag>title</tag> in header</phrase></screen>
  1501. </listitem>
  1502. <listitem>
  1503. <para><literal>David Cramer: template/common/css/positioning.css; template/common/images/main_bg_fade.png</literal></para><screen><phrase role="commit-message">Adjusting default color of the header</phrase></screen>
  1504. </listitem>
  1505. <listitem>
  1506. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">adjustments to header <tag>title</tag>. Now output in Opera looks good.</phrase></screen>
  1507. </listitem>
  1508. <listitem>
  1509. <para><literal>kasunbg: template/common/images/sidebar.png; template/content/search/punctuation.props; te&#x22EF;</literal></para><screen><phrase role="commit-message">deleting svn:executable flag from webhelp files</phrase></screen>
  1510. </listitem>
  1511. <listitem>
  1512. <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; template/common/images/sear&#x22EF;</literal></para><screen><phrase role="commit-message">Customized the left navagation headers; Contents and Search.
  1513. Adding custom css for the current redmond ui of jquery-ui. These override jquery-ui's default css customizations. These are supposed to take precedence.</phrase></screen>
  1514. </listitem>
  1515. <listitem>
  1516. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">typo fix</phrase></screen>
  1517. </listitem>
  1518. <listitem>
  1519. <para><literal>kasunbg: template/common/images/next-arrow.png; xsl/webhelp.xsl; template/common/main.js; &#x22EF;</literal></para><screen><phrase role="commit-message">UI improvements.
  1520. Moved search highligher to search tab.
  1521. Added nice icons for navigation buttons etc.
  1522. Removed footer navigation
  1523. Corrected tree colorings
  1524. Overall, some css magic</phrase></screen>
  1525. </listitem>
  1526. <listitem>
  1527. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Added <tag>listitem</tag> thinking SyncRO Soft for their contributions.</phrase></screen>
  1528. </listitem>
  1529. <listitem>
  1530. <para><literal>kasunbg: build.xml</literal></para><screen><phrase role="commit-message">support for default classpath for Gentoo Linux</phrase></screen>
  1531. </listitem>
  1532. <listitem>
  1533. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">webhelp - some updates to the documentation about search</phrase></screen>
  1534. </listitem>
  1535. <listitem>
  1536. <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Fix for issue 'Keep "search" &amp; "contents" titles always visible in webhelp - ID: 3403438'</phrase></screen>
  1537. </listitem>
  1538. <listitem>
  1539. <para><literal>David Cramer: template/common/images/starsSmall.png</literal></para><screen><phrase role="commit-message">Changed icons used to show search weightings from stars to boxes so they won't look like user ratings</phrase></screen>
  1540. </listitem>
  1541. <listitem>
  1542. <para><literal>David Cramer: xsl/webhelp.xsl; template/common/main.js; template/common/images/starsSmall.&#x22EF;</literal></para><screen><phrase role="commit-message">Merged Oxygen webhelp improvements (search weightings etc) into trunk: -r9031:9039</phrase></screen>
  1543. </listitem>
  1544. <listitem>
  1545. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">webhelp documentation - search indexing, faq</phrase></screen>
  1546. </listitem>
  1547. <listitem>
  1548. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">update webhelp documentation</phrase></screen>
  1549. </listitem>
  1550. <listitem>
  1551. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Fixed bug where <parameter>webhelp.default.topic</parameter> was not being used if it was set</phrase></screen>
  1552. </listitem>
  1553. <listitem>
  1554. <para><literal>David Cramer: xsl/webhelp.xsl; template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Localize string in nwSearchFnt.js file</phrase></screen>
  1555. </listitem>
  1556. <listitem>
  1557. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added tabindex attributes to make tab order in UI more logical in webhelp.</phrase></screen>
  1558. </listitem>
  1559. <listitem>
  1560. <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Fixed bug where anchors in pages landed beneath the banner.</phrase></screen>
  1561. </listitem>
  1562. <listitem>
  1563. <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added more comments to the xsl/webhelp/xsl/webhelp.xsl file. Removed some clutter.</phrase></screen>
  1564. </listitem>
  1565. <listitem>
  1566. <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Fixed problem reported in IE 8. See tracker id # 373747.</phrase></screen>
  1567. </listitem>
  1568. <listitem>
  1569. <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Addressed tracker #3247166 by removing hard-coded <tag>reference</tag> to ch01.html.</phrase></screen>
  1570. </listitem>
  1571. <listitem>
  1572. <para><literal>kasunbg: build.xml</literal></para><screen><phrase role="commit-message">Changed the webhelp build.xml to reflect the changes to xsl-webhelpindexer.
  1573. Added classpaths for xercesImpl and xml-api jars to the indexer. Paths added for *nix environments, need to look at how the current system behaves in Windows. Discussion: http://lists.oasis-open.org/archives/docbook-apps/201011/msg00116.html</phrase></screen>
  1574. </listitem>
  1575. <listitem>
  1576. <para><literal>kasunbg: template/common/images/loading.gif; template/common/jquery/treeview/jquery.treevi&#x22EF;</literal></para><screen><phrase role="commit-message">webhelp: Removing some unnecessary JQuery JS files</phrase></screen>
  1577. </listitem>
  1578. <listitem>
  1579. <para><literal>kasunbg: template/common/main.js</literal></para><screen><phrase role="commit-message">webhelp: Usability improvement - when click on a node in the <tag>TOC</tag> tree, the child nodes will auto populate now.</phrase></screen>
  1580. </listitem>
  1581. <listitem>
  1582. <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added google translated localizations for Japanese, German, French, and Chinese. The translations might not be pretty accurate.
  1583. Better translations are appreciated.</phrase></screen>
  1584. </listitem>
  1585. <listitem>
  1586. <para><literal>kasunbg: docsrc/readme.xml; template/content/images; template/content/images/sample.jpg</literal></para><screen><phrase role="commit-message">Added documentation for how to add images to WebHelp</phrase></screen>
  1587. </listitem>
  1588. <listitem>
  1589. <para><literal>Jirka Kosek: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added more customization hooks
  1590. Search code output only when search tab is active
  1591. Added cs localization</phrase></screen>
  1592. </listitem>
  1593. <listitem>
  1594. <para><literal>Jirka Kosek: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added parameter <parameter>webhelp.common.dir</parameter> for specifying location of common files (JS+CSS)
  1595. Added hooks for adding additional user defined tabs</phrase></screen>
  1596. </listitem>
  1597. </itemizedlist>
  1598. </sect2><!--end of Webhelp changes for snapshot_-->
  1599. <sect2 xml:id="rnV1.77_Params">
  1600. <title>Params</title>
  1601. <para>The following changes have been made to the
  1602. <filename>params</filename> code
  1603. since the 1.76.1 release.</para>
  1604. <itemizedlist>
  1605. <listitem>
  1606. <para><literal>David Cramer: webhelp.indexer.language.xml</literal></para><screen><phrase role="commit-message">Webhelp: Fixing list of supported languages</phrase></screen>
  1607. </listitem>
  1608. <listitem>
  1609. <para><literal>David Cramer: webhelp.indexer.language.xml</literal></para><screen><phrase role="commit-message">Webhelp: Correct language code in docs for Chinese</phrase></screen>
  1610. </listitem>
  1611. <listitem>
  1612. <para><literal>Mauritz Jeanson: admon.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Added list of graphics formats.</phrase></screen>
  1613. </listitem>
  1614. <listitem>
  1615. <para><literal>Mauritz Jeanson: passivetex.extensions.xml</literal></para><screen><phrase role="commit-message">Updated <tag>link</tag>.</phrase></screen>
  1616. </listitem>
  1617. <listitem>
  1618. <para><literal>tom_schr: webhelp.indexer.language.xml; webhelp.default.topic.xml; webhelp.tree.cookie.id.&#x22EF;</literal></para><screen><phrase role="commit-message">Prepared WebHelp <tag>reference</tag> documentation :)
  1619. Not clear about parameters brandname and branding: Should they renamed
  1620. to "webhelp.branding" and "webhelp.brandname"?
  1621. Currently, docsrc/reference.xml contains only a comment for the WebHelp
  1622. ref doc to be non-intrusive.
  1623. Idea is to enable it when it is ready</phrase></screen>
  1624. </listitem>
  1625. <listitem>
  1626. <para><literal>Robert Stayton: glossary.collection.xml</literal></para><screen><phrase role="commit-message">Add <tag>info</tag> about relative paths.</phrase></screen>
  1627. </listitem>
  1628. <listitem>
  1629. <para><literal>Robert Stayton: para.properties.xml</literal></para><screen><phrase role="commit-message">Special attribute-set for <tag>para</tag> only.</phrase></screen>
  1630. </listitem>
  1631. <listitem>
  1632. <para><literal>Robert Stayton: table.caption.properties.xml</literal></para><screen><phrase role="commit-message">To format <tag>table</tag> captions.</phrase></screen>
  1633. </listitem>
  1634. <listitem>
  1635. <para><literal>Robert Stayton: html.script.type.xml; html.script.xml</literal></para><screen><phrase role="commit-message">Add support for specifying javascript references like css references.</phrase></screen>
  1636. </listitem>
  1637. <listitem>
  1638. <para><literal>Robert Stayton: body.margin.outer.xml; region.outer.extent.xml; body.margin.inner.xml; reg&#x22EF;</literal></para><screen><phrase role="commit-message">Add support for side regions in FO output.</phrase></screen>
  1639. </listitem>
  1640. <listitem>
  1641. <para><literal>Robert Stayton: chunked.filename.prefix.xml</literal></para><screen><phrase role="commit-message">New param <parameter>chunked.filename.prefix</parameter> to separate any such prefix from
  1642. the <parameter>base.dir</parameter> param, which helps fix bug 3087359.</phrase></screen>
  1643. </listitem>
  1644. <listitem>
  1645. <para><literal>Robert Stayton: generate.consistent.ids.xml</literal></para><screen><phrase role="commit-message">New param to support replacing generate-id() with xsl:number
  1646. for more consistent id values.</phrase></screen>
  1647. </listitem>
  1648. <listitem>
  1649. <para><literal>Robert Stayton: task.properties.xml</literal></para><screen><phrase role="commit-message">Allow <tag>task</tag> to be customized more easily.</phrase></screen>
  1650. </listitem>
  1651. <listitem>
  1652. <para><literal>Robert Stayton: calloutlist.properties.xml; callout.properties.xml</literal></para><screen><phrase role="commit-message">Support better customization of <tag>callout</tag> lists.</phrase></screen>
  1653. </listitem>
  1654. <listitem>
  1655. <para><literal>Jirka Kosek: callout.unicode.start.character.xml</literal></para><screen><phrase role="commit-message">Added support for alternative circled numbers</phrase></screen>
  1656. </listitem>
  1657. <listitem>
  1658. <para><literal>David Cramer: example.properties.xml</literal></para><screen><phrase role="commit-message">Made <parameter>example.properties</parameter> use keep-together='auto' like table.properies to avoid problems where example/<tag>programlisting</tag> takes more than one page</phrase></screen>
  1659. </listitem>
  1660. <listitem>
  1661. <para><literal>Mauritz Jeanson: graphicsize.extension.xml</literal></para><screen><phrase role="commit-message">Added <tag>info</tag> about supported image formats.</phrase></screen>
  1662. </listitem>
  1663. </itemizedlist>
  1664. </sect2><!--end of Params changes for snapshot_-->
  1665. <sect2 xml:id="rnV1.77_Highlighting">
  1666. <title>Highlighting</title>
  1667. <para>The following changes have been made to the
  1668. <filename>highlighting</filename> code
  1669. since the 1.76.1 release.</para>
  1670. <itemizedlist>
  1671. <listitem>
  1672. <para><literal>Jirka Kosek: csharp-hl.xml</literal></para><screen><phrase role="commit-message">Added LINQ keywords</phrase></screen>
  1673. </listitem>
  1674. <listitem>
  1675. <para><literal>Jirka Kosek: delphi-hl.xml</literal></para><screen><phrase role="commit-message">Additional keywords from Yuri Zhilin</phrase></screen>
  1676. </listitem>
  1677. </itemizedlist>
  1678. </sect2><!--end of Highlighting changes for snapshot_-->
  1679. <sect2 xml:id="rnV1.77_Profiling">
  1680. <title>Profiling</title>
  1681. <para>The following changes have been made to the
  1682. <filename>profiling</filename> code
  1683. since the 1.76.1 release.</para>
  1684. <itemizedlist>
  1685. <listitem>
  1686. <para><literal>David Cramer: profile-mode.xsl</literal></para><screen><phrase role="commit-message">When profile.* params only consist of space characters, then ignore them.</phrase></screen>
  1687. </listitem>
  1688. </itemizedlist>
  1689. </sect2><!--end of Profiling changes for snapshot_-->
  1690. <sect2 xml:id="rnV1.77_Lib">
  1691. <title>Lib</title>
  1692. <para>The following changes have been made to the
  1693. <filename>lib</filename> code
  1694. since the 1.76.1 release.</para>
  1695. <itemizedlist>
  1696. <listitem>
  1697. <para><literal>Robert Stayton: lib.xweb</literal></para><screen><phrase role="commit-message">Added two utility templates to make lib.xsl work
  1698. without <tag>reference</tag> to other modules since it is used
  1699. that way with profiling/xsl2profile.xsl.</phrase></screen>
  1700. </listitem>
  1701. <listitem>
  1702. <para><literal>Robert Stayton: lib.xweb</literal></para><screen><phrase role="commit-message">Fix trim.common.uri.paths to first resolve any ../ in
  1703. the paths.</phrase></screen>
  1704. </listitem>
  1705. </itemizedlist>
  1706. </sect2><!--end of Lib changes for snapshot_-->
  1707. <sect2 xml:id="rnV1.77_Template">
  1708. <title>Template</title>
  1709. <para>The following changes have been made to the
  1710. <filename>template</filename> code
  1711. since the 1.76.1 release.</para>
  1712. <itemizedlist>
  1713. <listitem>
  1714. <para><literal>Jirka Kosek: titlepage.xsl</literal></para><screen><phrase role="commit-message">Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.</phrase></screen>
  1715. </listitem>
  1716. </itemizedlist>
  1717. </sect2><!--end of Template changes for snapshot_-->
  1718. <sect2 xml:id="rnV1.77_Extensions">
  1719. <title>Extensions</title>
  1720. <para>The following changes have been made to the
  1721. <filename>extensions</filename> code
  1722. since the 1.76.1 release.</para>
  1723. <itemizedlist>
  1724. <listitem>
  1725. <para><literal>kasunbg: Makefile</literal></para><screen><phrase role="commit-message">webhelp - Adding enable.stemming, toc.file build properties</phrase></screen>
  1726. </listitem>
  1727. <listitem>
  1728. <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Attempt to convince Makefile that webhelpindexer is dirty</phrase></screen>
  1729. </listitem>
  1730. </itemizedlist>
  1731. </sect2><!--end of Extensions changes for snapshot_-->
  1732. <sect2 xml:id="rnV1.77_XSL-Saxon">
  1733. <title>XSL-Saxon</title>
  1734. <para>The following changes have been made to the
  1735. <filename>xsl-saxon</filename> code
  1736. since the 1.76.1 release.</para>
  1737. <itemizedlist>
  1738. <listitem>
  1739. <para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/Verbatim.java; src/com/nwalsh/saxon/FormatGraphicCal&#x22EF;</literal></para><screen><phrase role="commit-message">Added fixes to ensure that generated XHTML markup for callouts is in the proper namespace.</phrase></screen>
  1740. </listitem>
  1741. </itemizedlist>
  1742. </sect2><!--end of XSL-Saxon changes for snapshot_-->
  1743. </sect1>
  1744. <sect1 xml:id="V1.77.1">
  1745. <title>Release Notes: 1.77.1</title>
  1746. <para>The following is a list of changes that have been made
  1747. since the 1.77.0 release.</para>
  1748. <sect2 xml:id="Vsnapshot_9396_FO">
  1749. <title>FO</title>
  1750. <para>The following changes have been made to the
  1751. <filename>fo</filename> code
  1752. since the 1.77.0 release.</para>
  1753. <itemizedlist>
  1754. <listitem>
  1755. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
  1756. from the <tag>filename</tag>.</phrase></screen>
  1757. </listitem>
  1758. <listitem>
  1759. <para><literal>Robert Stayton: block.xsl</literal></para><screen><phrase role="commit-message">In <tag>sidebar</tag>, turn off space before first <tag>para</tag> if there is no <tag>title</tag>.</phrase></screen>
  1760. </listitem>
  1761. <listitem>
  1762. <para><literal>Robert Stayton: math.xsl</literal></para><screen><phrase role="commit-message">Restored templates for mml:* elements that were accidentally deleted.</phrase></screen>
  1763. </listitem>
  1764. </itemizedlist>
  1765. </sect2><!--end of FO changes for snapshot_9396-->
  1766. <sect2 xml:id="Vsnapshot_9396_HTML">
  1767. <title>HTML</title>
  1768. <para>The following changes have been made to the
  1769. <filename>html</filename> code
  1770. since the 1.77.0 release.</para>
  1771. <itemizedlist>
  1772. <listitem>
  1773. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
  1774. from the <tag>filename</tag>.</phrase></screen>
  1775. </listitem>
  1776. <listitem>
  1777. <para><literal>Robert Stayton: sections.xsl</literal></para><screen><phrase role="commit-message">Use $div.element variable in place of div to support html5 <tag>section</tag> element.
  1778. output</phrase></screen>
  1779. </listitem>
  1780. <listitem>
  1781. <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3528673, missing "separator" param on template with
  1782. match="<tag>indexterm</tag>" mode="<tag>reference</tag>". That param is passed
  1783. for endofrange processing to output the range separator.</phrase></screen>
  1784. </listitem>
  1785. </itemizedlist>
  1786. </sect2><!--end of HTML changes for snapshot_9396-->
  1787. <sect2 xml:id="Vsnapshot_9396_Roundtrip">
  1788. <title>Roundtrip</title>
  1789. <para>The following changes have been made to the
  1790. <filename>roundtrip</filename> code
  1791. since the 1.77.0 release.</para>
  1792. <itemizedlist>
  1793. <listitem>
  1794. <para><literal>Robert Stayton: dbk2ooo.xsl; dbk2pages.xsl; dbk2wordml.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
  1795. from the <tag>filename</tag>.</phrase></screen>
  1796. </listitem>
  1797. </itemizedlist>
  1798. </sect2><!--end of Roundtrip changes for snapshot_9396-->
  1799. <sect2 xml:id="Vsnapshot_9396_Slides">
  1800. <title>Slides</title>
  1801. <para>The following changes have been made to the
  1802. <filename>slides</filename> code
  1803. since the 1.77.0 release.</para>
  1804. <itemizedlist>
  1805. <listitem>
  1806. <para><literal>Robert Stayton: html/slides-common.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
  1807. from the <tag>filename</tag>.</phrase></screen>
  1808. </listitem>
  1809. </itemizedlist>
  1810. </sect2><!--end of Slides changes for snapshot_9396-->
  1811. <sect2 xml:id="Vsnapshot_9396_Website">
  1812. <title>Website</title>
  1813. <para>The following changes have been made to the
  1814. <filename>website</filename> code
  1815. since the 1.77.0 release.</para>
  1816. <itemizedlist>
  1817. <listitem>
  1818. <para><literal>Robert Stayton: website-common.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
  1819. from the <tag>filename</tag>.</phrase></screen>
  1820. </listitem>
  1821. </itemizedlist>
  1822. </sect2><!--end of Website changes for snapshot_9396-->
  1823. <sect2 xml:id="Vsnapshot_9396_Webhelp">
  1824. <title>Webhelp</title>
  1825. <para>The following changes have been made to the
  1826. <filename>webhelp</filename> code
  1827. since the 1.77.0 release.</para>
  1828. <itemizedlist>
  1829. <listitem>
  1830. <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">updated webhelp documentation</phrase></screen>
  1831. </listitem>
  1832. <listitem>
  1833. <para><literal>kasunbg: template/content/search/nwSearchFnt.js; xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Removed the script htmlFileList.js since it's content is in htmlFileInfoList.js</phrase></screen>
  1834. </listitem>
  1835. <listitem>
  1836. <para><literal>Robert Stayton: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">In the &lt;h1&gt; output, replace call to 'get.doc.title' with
  1837. mode="title.markup" because get.doc.title returns only
  1838. the string value of the <tag>title</tag>, losing any markup such
  1839. as &lt;<tag>trademark</tag>&gt; or &lt;<tag>superscript</tag>&gt;.</phrase></screen>
  1840. </listitem>
  1841. <listitem>
  1842. <para><literal>kasunbg: template/common/css/positioning.css; template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Remove unnecessary bits of code from webhelp</phrase></screen>
  1843. </listitem>
  1844. <listitem>
  1845. <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Minor edits to the readme</phrase></screen>
  1846. </listitem>
  1847. <listitem>
  1848. <para><literal>David Cramer: xsl/webhelp.xsl; xsl/titlepage.templates.xsl; xsl/titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Webhelp: Suppress abstracts from titlepages. These are used to create the search result summary sentence and should not be shown</phrase></screen>
  1849. </listitem>
  1850. <listitem>
  1851. <para><literal>David Cramer: build.xml</literal></para><screen><phrase role="commit-message">Webhelp: calculate path to profile.xsl from main build.xml file</phrase></screen>
  1852. </listitem>
  1853. </itemizedlist>
  1854. </sect2><!--end of Webhelp changes for snapshot_9396-->
  1855. </sect1>
  1856. <sect1 xml:id="V1.76.1">
  1857. <title>Release Notes: 1.76.1</title>
  1858. <para>The following is a list of changes that have been made
  1859. since the 1.76.0 release.</para>
  1860. <sect2 xml:id="rnV1.76.1_FO">
  1861. <title>FO</title>
  1862. <para>The following changes have been made to the
  1863. <filename>fo</filename> code
  1864. since the 1.76.0 release.</para>
  1865. <itemizedlist>
  1866. <listitem>
  1867. <para><literal>Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl</literal></para><screen><phrase role="commit-message">Apply patch to support named destination in fop1.xsl, per Sourceforge
  1868. bug report #3029845.</phrase></screen>
  1869. </listitem>
  1870. </itemizedlist>
  1871. </sect2><!--end of FO changes for 1.76.1-->
  1872. <sect2 xml:id="rnV1.76.1_HTML">
  1873. <title>HTML</title>
  1874. <para>The following changes have been made to the <filename>html</filename> code since the 1.76.0 release.</para>
  1875. <itemizedlist>
  1876. <listitem>
  1877. <para><literal>Keith Fahlgren: highlight.xsl</literal></para><screen><phrase role="commit-message">Implementing handling for &lt;b&gt; and &lt;i&gt;: transform to &lt;strong&gt; and &lt;em&gt; for XHTML outputs and do not use in the highliting output (per Mauritz Jeanson)</phrase></screen>
  1878. </listitem>
  1879. </itemizedlist>
  1880. </sect2><!--end of HTML changes for 1.76.1-->
  1881. <sect2 xml:id="rnV1.76.1_Params">
  1882. <title>Params</title>
  1883. <para>The following changes have been made to the
  1884. <filename>params</filename> code
  1885. since the 1.76.0 release.</para>
  1886. <itemizedlist>
  1887. <listitem>
  1888. <para><literal>Robert Stayton: draft.mode.xml</literal></para><screen><phrase role="commit-message">Change default for <parameter>draft.mode</parameter> to 'no'.</phrase></screen>
  1889. </listitem>
  1890. </itemizedlist>
  1891. </sect2><!--end of Params changes for 1.76.1-->
  1892. </sect1>
  1893. <sect1 xml:id="V1.76.0">
  1894. <title>Release Notes: 1.76.0</title>
  1895. <para>This release includes important bug fixes and adds the following
  1896. significant feature changes:</para>
  1897. <variablelist>
  1898. <varlistentry>
  1899. <term>Webhelp</term>
  1900. <listitem><para>A new browser-based, cross-platform help format with full-text search and other features typically found in help systems. See <filename>webhelp/docs/content/ch01.html</filename> for more information and a demo. </para></listitem>
  1901. </varlistentry>
  1902. <varlistentry>
  1903. <term>Gentext</term>
  1904. <listitem><para>Many updates and additions to translation/locales thanks to Red Hat, the Fedora Project, and other contributors.</para></listitem>
  1905. </varlistentry>
  1906. <varlistentry>
  1907. <term>Common</term>
  1908. <listitem><para>Faster localization support, as language files are loaded on demand.</para></listitem>
  1909. </varlistentry>
  1910. <varlistentry>
  1911. <term>FO</term>
  1912. <listitem><para>Support for SVG content in <tag>imagedata</tag> added.</para></listitem>
  1913. </varlistentry>
  1914. <varlistentry>
  1915. <term>HTML</term>
  1916. <listitem><para>Output improved when using '<parameter>make.clean.html</parameter>' and a stock CSS file is now provided.</para></listitem>
  1917. </varlistentry>
  1918. <varlistentry>
  1919. <term>EPUB</term>
  1920. <listitem><para>A number of improvements to NCX, cover and image selection, and XHTML 1.1 element choices</para></listitem>
  1921. </varlistentry>
  1922. </variablelist>
  1923. <para>The following is a list of changes that have been made since the 1.75.2 release.</para>
  1924. <sect2 xml:id="rnV1.76.0_Gentext">
  1925. <title>Gentext</title>
  1926. <para>The following changes have been made to the <filename>gentext</filename> code since the 1.75.2 release.</para>
  1927. <itemizedlist>
  1928. <listitem>
  1929. <para>
  1930. <literal>rlandmann: locale/fa.xml</literal>
  1931. </para>
  1932. <screen>
  1933. <phrase role="commit-message">Update to Persian translation from the Fedora Project</phrase>
  1934. </screen>
  1935. </listitem>
  1936. <listitem>
  1937. <para>
  1938. <literal>rlandmann: locale/nds.xml</literal>
  1939. </para>
  1940. <screen>
  1941. <phrase role="commit-message">Locale for Low German</phrase>
  1942. </screen>
  1943. </listitem>
  1944. <listitem>
  1945. <para>
  1946. <literal>Mauritz Jeanson: locale/ka.xml; Makefile</literal>
  1947. </para>
  1948. <screen>
  1949. <phrase role="commit-message">Added support for Georgian based on patch #2917147.</phrase>
  1950. </screen>
  1951. </listitem>
  1952. <listitem>
  1953. <para>
  1954. <literal>rlandmann: locale/nl.xml; locale/ja.xml</literal>
  1955. </para>
  1956. <screen>
  1957. <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
  1958. </screen>
  1959. </listitem>
  1960. <listitem>
  1961. <para>
  1962. <literal>rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml</literal>
  1963. </para>
  1964. <screen>
  1965. <phrase role="commit-message">Updated locales from Red Hat and the Fedora Project</phrase>
  1966. </screen>
  1967. </listitem>
  1968. <listitem>
  1969. <para>
  1970. <literal>rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml; locale/nl.xml; loca&#x22EF;</literal>
  1971. </para>
  1972. <screen>
  1973. <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
  1974. </screen>
  1975. </listitem>
  1976. <listitem>
  1977. <para>
  1978. <literal>rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml; locale/te.xml; &#x22EF;</literal>
  1979. </para>
  1980. <screen>
  1981. <phrase role="commit-message">New translations from Red Hat and the Fedora Project</phrase>
  1982. </screen>
  1983. </listitem>
  1984. <listitem>
  1985. <para>
  1986. <literal>rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml; locale/ru.xml; loca&#x22EF;</literal>
  1987. </para>
  1988. <screen>
  1989. <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
  1990. </screen>
  1991. </listitem>
  1992. </itemizedlist>
  1993. </sect2>
  1994. <!--end of Gentext changes for 1.76.0-->
  1995. <sect2 xml:id="rnV1.76.0_Common">
  1996. <title>Common</title>
  1997. <para>The following changes have been made to the <filename>common</filename> code since the 1.75.2 release.</para>
  1998. <itemizedlist>
  1999. <listitem>
  2000. <para>
  2001. <literal>Mauritz Jeanson: common.xsl</literal>
  2002. </para>
  2003. <screen>
  2004. <phrase role="commit-message">Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).</phrase>
  2005. </screen>
  2006. </listitem>
  2007. <listitem>
  2008. <para>
  2009. <literal>Mauritz Jeanson: gentext.xsl</literal>
  2010. </para>
  2011. <screen>
  2012. <phrase role="commit-message">Added fix to catch ID also of descendants of <tag>listitem</tag>. Closes bug #2955077.</phrase>
  2013. </screen>
  2014. </listitem>
  2015. <listitem>
  2016. <para>
  2017. <literal>Jirka Kosek: l10n.xsl</literal>
  2018. </para>
  2019. <screen>
  2020. <phrase role="commit-message">Stripped down, faster version of gentext.template is used when there is no localization customization.</phrase>
  2021. </screen>
  2022. </listitem>
  2023. <listitem>
  2024. <para>
  2025. <literal>Mauritz Jeanson: stripns.xsl</literal>
  2026. </para>
  2027. <screen>
  2028. <phrase role="commit-message">Added fix that preserves <tag>link</tag>/@role (makes links in the <tag>reference</tag> documentation
  2029. with @role="tcg" work).</phrase>
  2030. </screen>
  2031. </listitem>
  2032. <listitem>
  2033. <para>
  2034. <literal>Mauritz Jeanson: l10n.xsl</literal>
  2035. </para>
  2036. <screen>
  2037. <phrase role="commit-message">Fixed bugs related to manpages and L10n.</phrase>
  2038. </screen>
  2039. </listitem>
  2040. <listitem>
  2041. <para>
  2042. <literal>Jirka Kosek: entities.ent; autoidx-kosek.xsl</literal>
  2043. </para>
  2044. <screen>
  2045. <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
  2046. </screen>
  2047. </listitem>
  2048. <listitem>
  2049. <para>
  2050. <literal>Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl</literal>
  2051. </para>
  2052. <screen>
  2053. <phrase role="commit-message">Refactored localization support. Language files are loaded on demand. Speedup is about 30%.</phrase>
  2054. </screen>
  2055. </listitem>
  2056. <listitem>
  2057. <para>
  2058. <literal>Jirka Kosek: l10n.xsl</literal>
  2059. </para>
  2060. <screen>
  2061. <phrase role="commit-message">Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.</phrase>
  2062. </screen>
  2063. </listitem>
  2064. <listitem>
  2065. <para>
  2066. <literal>Mauritz Jeanson: titles.xsl</literal>
  2067. </para>
  2068. <screen>
  2069. <phrase role="commit-message">Fixed bug #2912677 (error with <tag>xref</tag> in <tag>title</tag>).</phrase>
  2070. </screen>
  2071. </listitem>
  2072. <listitem>
  2073. <para>
  2074. <literal>Robert Stayton: olink.xsl</literal>
  2075. </para>
  2076. <screen>
  2077. <phrase role="commit-message">Fix bug in xrefstyle "<tag>title</tag>" handling introduced with
  2078. the 'insert.targetdb.data' template.</phrase>
  2079. </screen>
  2080. </listitem>
  2081. <listitem>
  2082. <para>
  2083. <literal>Robert Stayton: gentext.xsl</literal>
  2084. </para>
  2085. <screen>
  2086. <phrase role="commit-message">Fix bug in <tag>xref</tag> to <tag>equation</tag> without <tag>title</tag> to use context="xref-number" instead
  2087. of "xref-number-and-title".</phrase>
  2088. </screen>
  2089. </listitem>
  2090. <listitem>
  2091. <para>
  2092. <literal>Robert Stayton: labels.xsl</literal>
  2093. </para>
  2094. <screen>
  2095. <phrase role="commit-message">Number all equations in one sequence, with or without <tag>title</tag>.</phrase>
  2096. </screen>
  2097. </listitem>
  2098. <listitem>
  2099. <para>
  2100. <literal>Robert Stayton: entities.ent</literal>
  2101. </para>
  2102. <screen>
  2103. <phrase role="commit-message">Fix bug #2896909 where duplicate @sortas on indexterms caused
  2104. some indexterms to drop out of <tag>index</tag>.</phrase>
  2105. </screen>
  2106. </listitem>
  2107. <listitem>
  2108. <para>
  2109. <literal>Robert Stayton: stripns.xsl</literal>
  2110. </para>
  2111. <screen>
  2112. <phrase role="commit-message">Expand the "Stripping namespace ..." message to advise users to
  2113. use the namespaced stylesheets.</phrase>
  2114. </screen>
  2115. </listitem>
  2116. <listitem>
  2117. <para>
  2118. <literal>Robert Stayton: stripns.xsl</literal>
  2119. </para>
  2120. <screen>
  2121. <phrase role="commit-message">need a local version of $exsl.node.set.available variable because
  2122. this module imported many places.</phrase>
  2123. </screen>
  2124. </listitem>
  2125. <listitem>
  2126. <para>
  2127. <literal>Mauritz Jeanson: olink.xsl</literal>
  2128. </para>
  2129. <screen>
  2130. <phrase role="commit-message">Added /node() to the select expression that is used to compute the <tag>title</tag> text
  2131. so that no &lt;ttl&gt; elements end up in the output. Closes bug #2830119.</phrase>
  2132. </screen>
  2133. </listitem>
  2134. </itemizedlist>
  2135. </sect2>
  2136. <!--end of Common changes for 1.76.0-->
  2137. <sect2 xml:id="rnV1.76.0_FO">
  2138. <title>FO</title>
  2139. <para>The following changes have been made to the
  2140. <filename>fo</filename> code
  2141. since the 1.75.2 release.</para>
  2142. <itemizedlist>
  2143. <listitem>
  2144. <para>
  2145. <literal>Robert Stayton: table.xsl</literal>
  2146. </para>
  2147. <screen>
  2148. <phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
  2149. </screen>
  2150. </listitem>
  2151. <listitem>
  2152. <para>
  2153. <literal>Mauritz Jeanson: inline.xsl</literal>
  2154. </para>
  2155. <screen>
  2156. <phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
  2157. with many inline glossterms.</phrase>
  2158. </screen>
  2159. </listitem>
  2160. <listitem>
  2161. <para>
  2162. <literal>Robert Stayton: titlepage.xsl</literal>
  2163. </para>
  2164. <screen>
  2165. <phrase role="commit-message">Fix bug 2805530 <tag>author</tag>/<tag>orgname</tag> not appearing on <tag>title</tag> page.</phrase>
  2166. </screen>
  2167. </listitem>
  2168. <listitem>
  2169. <para>
  2170. <literal>Mauritz Jeanson: graphics.xsl</literal>
  2171. </para>
  2172. <screen>
  2173. <phrase role="commit-message">Added support for SVG content in <tag>imagedata</tag> (inspired by patch #2909154).</phrase>
  2174. </screen>
  2175. </listitem>
  2176. <listitem>
  2177. <para>
  2178. <literal>Mauritz Jeanson: table.xsl</literal>
  2179. </para>
  2180. <screen>
  2181. <phrase role="commit-message">Removed superfluous test used when computing column-width. Closes bug #3000898.</phrase>
  2182. </screen>
  2183. </listitem>
  2184. <listitem>
  2185. <para>
  2186. <literal>Mauritz Jeanson: inline.xsl</literal>
  2187. </para>
  2188. <screen>
  2189. <phrase role="commit-message">Added missing &lt;xsl:call-template name="<tag>anchor</tag>"/&gt;. Closes bug #2998567.</phrase>
  2190. </screen>
  2191. </listitem>
  2192. <listitem>
  2193. <para>
  2194. <literal>Mauritz Jeanson: lists.xsl</literal>
  2195. </para>
  2196. <screen>
  2197. <phrase role="commit-message">Added table-layout="fixed" on <tag>segmentedlist</tag> <tag>table</tag> (required by XSL spec when proportional-column-width() is used).</phrase>
  2198. </screen>
  2199. </listitem>
  2200. <listitem>
  2201. <para>
  2202. <literal>Jirka Kosek: autoidx-kosek.xsl</literal>
  2203. </para>
  2204. <screen>
  2205. <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
  2206. </screen>
  2207. </listitem>
  2208. <listitem>
  2209. <para>
  2210. <literal>Jirka Kosek: index.xsl</literal>
  2211. </para>
  2212. <screen>
  2213. <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
  2214. </screen>
  2215. </listitem>
  2216. <listitem>
  2217. <para>
  2218. <literal>Robert Stayton: xref.xsl</literal>
  2219. </para>
  2220. <screen>
  2221. <phrase role="commit-message">Fix bug in <tag>olink</tag> template when an <tag>olink</tag> has an id.
  2222. Add warning message with id value when trying to <tag>link</tag>
  2223. to an element that has no generated text.</phrase>
  2224. </screen>
  2225. </listitem>
  2226. <listitem>
  2227. <para>
  2228. <literal>Mauritz Jeanson: refentry.xsl</literal>
  2229. </para>
  2230. <screen>
  2231. <phrase role="commit-message">Fixed bug #2930968 (<tag>indexterm</tag> in <tag>refmeta</tag> not handled correctly).</phrase>
  2232. </screen>
  2233. </listitem>
  2234. <listitem>
  2235. <para>
  2236. <literal>Robert Stayton: block.xsl</literal>
  2237. </para>
  2238. <screen>
  2239. <phrase role="commit-message">fix bug 2949567 <tag>title</tag> in <tag>revhistory</tag> breaks FO transform.</phrase>
  2240. </screen>
  2241. </listitem>
  2242. <listitem>
  2243. <para>
  2244. <literal>Robert Stayton: glossary.xsl</literal>
  2245. </para>
  2246. <screen>
  2247. <phrase role="commit-message">Output id attributes on <tag>glossdiv</tag> blocks so they can be added to
  2248. xrefs or <tag>TOC</tag>.</phrase>
  2249. </screen>
  2250. </listitem>
  2251. <listitem>
  2252. <para>
  2253. <literal>Jirka Kosek: xref.xsl</literal>
  2254. </para>
  2255. <screen>
  2256. <phrase role="commit-message">Enabled hyphenation of URLs when ulink content is the same as <tag>link</tag> target</phrase>
  2257. </screen>
  2258. </listitem>
  2259. <listitem>
  2260. <para>
  2261. <literal>Robert Stayton: table.xsl</literal>
  2262. </para>
  2263. <screen>
  2264. <phrase role="commit-message">Apply patch to turn off <tag>row</tag> recursion if no @morerows attributes present.
  2265. This will enable very large tables without <tag>row</tag> spanning to
  2266. process without running into recursion limits.</phrase>
  2267. </screen>
  2268. </listitem>
  2269. <listitem>
  2270. <para>
  2271. <literal>Robert Stayton: formal.xsl</literal>
  2272. </para>
  2273. <screen>
  2274. <phrase role="commit-message">Format <tag>equation</tag> without <tag>title</tag> using <tag>table</tag> layout with <tag>equation</tag> number
  2275. next to the <tag>equation</tag>.</phrase>
  2276. </screen>
  2277. </listitem>
  2278. <listitem>
  2279. <para>
  2280. <literal>Robert Stayton: param.xweb; param.ent</literal>
  2281. </para>
  2282. <screen>
  2283. <phrase role="commit-message">Add <parameter>equation.number.properties</parameter>.</phrase>
  2284. </screen>
  2285. </listitem>
  2286. </itemizedlist>
  2287. </sect2>
  2288. <!--end of FO changes for 1.76.0-->
  2289. <sect2 xml:id="rnV1.76.0_HTML">
  2290. <title>HTML</title>
  2291. <para>The following changes have been made to the
  2292. <filename>html</filename> code
  2293. since the 1.75.2 release.</para>
  2294. <itemizedlist>
  2295. <listitem>
  2296. <para>
  2297. <literal>Mauritz Jeanson: block.xsl</literal>
  2298. </para>
  2299. <screen>
  2300. <phrase role="commit-message">Modified <tag>acknowledgements</tag> template to avoid invalid output (&lt;p&gt; in &lt;p&gt;).</phrase>
  2301. </screen>
  2302. </listitem>
  2303. <listitem>
  2304. <para>
  2305. <literal>Mauritz Jeanson: titlepage.xsl</literal>
  2306. </para>
  2307. <screen>
  2308. <phrase role="commit-message">Added default <tag>sidebar</tag> attribute-sets.</phrase>
  2309. </screen>
  2310. </listitem>
  2311. <listitem>
  2312. <para>
  2313. <literal>Robert Stayton: table.xsl</literal>
  2314. </para>
  2315. <screen>
  2316. <phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
  2317. </screen>
  2318. </listitem>
  2319. <listitem>
  2320. <para>
  2321. <literal>Robert Stayton: footnote.xsl</literal>
  2322. </para>
  2323. <screen>
  2324. <phrase role="commit-message">Fix bug 3033191 footnotes in html tables.</phrase>
  2325. </screen>
  2326. </listitem>
  2327. <listitem>
  2328. <para>
  2329. <literal>Mauritz Jeanson: inline.xsl</literal>
  2330. </para>
  2331. <screen>
  2332. <phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
  2333. with many inline glossterms.</phrase>
  2334. </screen>
  2335. </listitem>
  2336. <listitem>
  2337. <para>
  2338. <literal>Robert Stayton: docbook.css.xml; verbatim.xsl</literal>
  2339. </para>
  2340. <screen>
  2341. <phrase role="commit-message">Fix bug 2844927 Validity error for <tag>callout</tag> bugs.</phrase>
  2342. </screen>
  2343. </listitem>
  2344. <listitem>
  2345. <para>
  2346. <literal>Robert Stayton: formal.xsl</literal>
  2347. </para>
  2348. <screen>
  2349. <phrase role="commit-message">Convert formal.object.heading to respect <parameter>make.clean.html</parameter> param.</phrase>
  2350. </screen>
  2351. </listitem>
  2352. <listitem>
  2353. <para>
  2354. <literal>Robert Stayton: titlepage.templates.xml; block.xsl</literal>
  2355. </para>
  2356. <screen>
  2357. <phrase role="commit-message">Fix bug 2840768 <tag>sidebar</tag> without <tag>title</tag> inserts empty b <tag>tag</tag>.</phrase>
  2358. </screen>
  2359. </listitem>
  2360. <listitem>
  2361. <para>
  2362. <literal>Mauritz Jeanson: docbook.xsl</literal>
  2363. </para>
  2364. <screen>
  2365. <phrase role="commit-message">Moved the template that outputs &lt;base&gt; so that the base URI also applies to relative CSS paths that come later.
  2366. See patch #2896121.</phrase>
  2367. </screen>
  2368. </listitem>
  2369. <listitem>
  2370. <para>
  2371. <literal>Jirka Kosek: autoidx-kosek.xsl</literal>
  2372. </para>
  2373. <screen>
  2374. <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
  2375. </screen>
  2376. </listitem>
  2377. <listitem>
  2378. <para>
  2379. <literal>Robert Stayton: chunk-code.xsl</literal>
  2380. </para>
  2381. <screen>
  2382. <phrase role="commit-message">fix bug 2948363 generated <tag>filename</tag> for <tag>refentry</tag> not unique, when
  2383. used in a set.</phrase>
  2384. </screen>
  2385. </listitem>
  2386. <listitem>
  2387. <para>
  2388. <literal>Robert Stayton: component.xsl</literal>
  2389. </para>
  2390. <screen>
  2391. <phrase role="commit-message">Fix missing "<tag>Chapter</tag> n" <tag>label</tag> when use <tag>chapter</tag>/<tag>info</tag>/<tag>title</tag>.</phrase>
  2392. </screen>
  2393. </listitem>
  2394. <listitem>
  2395. <para>
  2396. <literal>Robert Stayton: table.xsl</literal>
  2397. </para>
  2398. <screen>
  2399. <phrase role="commit-message"><tag>Row</tag> recursion turned off if no @morerows attributes in the <tag>table</tag>.
  2400. This will prevent failure on long <tag>table</tag> (with no @morerows) due
  2401. to excessive depth of recursion.</phrase>
  2402. </screen>
  2403. </listitem>
  2404. <listitem>
  2405. <para>
  2406. <literal>Robert Stayton: autotoc.xsl; docbook.css.xml</literal>
  2407. </para>
  2408. <screen>
  2409. <phrase role="commit-message">Support <parameter>make.clean.html</parameter> in autotoc.xsl.</phrase>
  2410. </screen>
  2411. </listitem>
  2412. <listitem>
  2413. <para>
  2414. <literal>Robert Stayton: docbook.css.xml; block.xsl</literal>
  2415. </para>
  2416. <screen>
  2417. <phrase role="commit-message">Add support for <parameter>make.clean.html</parameter> setting in block elements.</phrase>
  2418. </screen>
  2419. </listitem>
  2420. <listitem>
  2421. <para>
  2422. <literal>Robert Stayton: docbook.css.xml</literal>
  2423. </para>
  2424. <screen>
  2425. <phrase role="commit-message">Stock CSS styles for DocBook HTML output when '<parameter>make.clean.html</parameter>' is non-zero.</phrase>
  2426. </screen>
  2427. </listitem>
  2428. <listitem>
  2429. <para>
  2430. <literal>Robert Stayton: html.xsl</literal>
  2431. </para>
  2432. <screen>
  2433. <phrase role="commit-message">Add templates for generating CSS files and links to them.</phrase>
  2434. </screen>
  2435. </listitem>
  2436. <listitem>
  2437. <para>
  2438. <literal>Robert Stayton: param.xweb</literal>
  2439. </para>
  2440. <screen>
  2441. <phrase role="commit-message">Fix bugs in new entity references.</phrase>
  2442. </screen>
  2443. </listitem>
  2444. <listitem>
  2445. <para>
  2446. <literal>Robert Stayton: chunk-common.xsl</literal>
  2447. </para>
  2448. <screen>
  2449. <phrase role="commit-message">List of Equations now includes on equations with titles.</phrase>
  2450. </screen>
  2451. </listitem>
  2452. <listitem>
  2453. <para>
  2454. <literal>Robert Stayton: table.xsl</literal>
  2455. </para>
  2456. <screen>
  2457. <phrase role="commit-message">If a <tag>colspec</tag> has a colname attribute, add it to the HTML <tag>col</tag>
  2458. element as a class attribute so it can be styled.</phrase>
  2459. </screen>
  2460. </listitem>
  2461. <listitem>
  2462. <para>
  2463. <literal>Robert Stayton: formal.xsl</literal>
  2464. </para>
  2465. <screen>
  2466. <phrase role="commit-message">Fix bug 2825842 where <tag>table</tag> footnotes not appearing in HTML-coded <tag>table</tag>.</phrase>
  2467. </screen>
  2468. </listitem>
  2469. <listitem>
  2470. <para>
  2471. <literal>Robert Stayton: chunktoc.xsl</literal>
  2472. </para>
  2473. <screen>
  2474. <phrase role="commit-message">Fix bug #2834826 where <tag>appendix</tag> inside part was not chunked as it should be.</phrase>
  2475. </screen>
  2476. </listitem>
  2477. <listitem>
  2478. <para>
  2479. <literal>Mauritz Jeanson: chunktoc.xsl</literal>
  2480. </para>
  2481. <screen>
  2482. <phrase role="commit-message">Added missing namespace declarations. Closes bug #2890069.</phrase>
  2483. </screen>
  2484. </listitem>
  2485. <listitem>
  2486. <para>
  2487. <literal>Mauritz Jeanson: footnote.xsl</literal>
  2488. </para>
  2489. <screen>
  2490. <phrase role="commit-message">Updated the template for <tag>footnote</tag> paras to use the 'paragraph' template. Closes bug #2803739.</phrase>
  2491. </screen>
  2492. </listitem>
  2493. <listitem>
  2494. <para>
  2495. <literal>Keith Fahlgren: inline.xsl; lists.xsl</literal>
  2496. </para>
  2497. <screen>
  2498. <phrase role="commit-message">Remove &lt;b&gt; and &lt;i&gt; elements "discouraged in favor of style sheets" from
  2499. XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
  2500. Fixes bug #2873153: No &lt;b&gt; and &lt;i&gt; tags in XHTML/EPUB
  2501. Added regression to EPUB specs:</phrase>
  2502. </screen>
  2503. </listitem>
  2504. <listitem>
  2505. <para>
  2506. <literal>Mauritz Jeanson: inline.xsl</literal>
  2507. </para>
  2508. <screen>
  2509. <phrase role="commit-message">Fixed bug #2844916 (don't output @target if <parameter>ulink.target</parameter> is empty).</phrase>
  2510. </screen>
  2511. </listitem>
  2512. <listitem>
  2513. <para>
  2514. <literal>Keith Fahlgren: autoidx.xsl</literal>
  2515. </para>
  2516. <screen>
  2517. <phrase role="commit-message">Fix a bug when using <parameter>index.on.type</parameter>: an '<tag>index</tag> symbols' <tag>section</tag> was created
  2518. even if that typed <tag>index</tag> didn't include any symbols (they were in the other types).</phrase>
  2519. </screen>
  2520. </listitem>
  2521. </itemizedlist>
  2522. </sect2>
  2523. <!--end of HTML changes for 1.76.0-->
  2524. <sect2 xml:id="rnV1.76.0_Manpages">
  2525. <title>Manpages</title>
  2526. <para>The following changes have been made to the
  2527. <filename>manpages</filename> code
  2528. since the 1.75.2 release.</para>
  2529. <itemizedlist>
  2530. <listitem>
  2531. <para>
  2532. <literal>Mauritz Jeanson: other.xsl</literal>
  2533. </para>
  2534. <screen>
  2535. <phrase role="commit-message">Modified the write.stubs template so that the <tag>section</tag> directory name is not output twice. Should fix bug #2831602.
  2536. Also ensured that $lang is added to the .so path (when <parameter>man.output.lang.in.name.enabled</parameter>=1).</phrase>
  2537. </screen>
  2538. </listitem>
  2539. <listitem>
  2540. <para>
  2541. <literal>Mauritz Jeanson: docbook.xsl; other.xsl</literal>
  2542. </para>
  2543. <screen>
  2544. <phrase role="commit-message">Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.</phrase>
  2545. </screen>
  2546. </listitem>
  2547. <listitem>
  2548. <para>
  2549. <literal>Norman Walsh: block.xsl; endnotes.xsl</literal>
  2550. </para>
  2551. <screen>
  2552. <phrase role="commit-message">Fix bug where <tag>simpara</tag> in <tag>footnote</tag> didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com</phrase>
  2553. </screen>
  2554. </listitem>
  2555. <listitem>
  2556. <para>
  2557. <literal>dleidert: lists.xsl</literal>
  2558. </para>
  2559. <screen>
  2560. <phrase role="commit-message">Fix two indentation issues: In the first case there is no corresponding .RS
  2561. macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
  2562. the probably intended .sp leads to an indentation bug (Debian #527309,
  2563. sf.net #2642139).</phrase>
  2564. </screen>
  2565. </listitem>
  2566. </itemizedlist>
  2567. </sect2>
  2568. <!--end of Manpages changes for 1.76.0-->
  2569. <sect2 xml:id="rnV1.76.0_Epub">
  2570. <title>Epub</title>
  2571. <para>The following changes have been made to the
  2572. <filename>epub</filename> code
  2573. since the 1.75.2 release.</para>
  2574. <itemizedlist>
  2575. <listitem>
  2576. <para>
  2577. <literal>Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec/epub_spec.rb</literal>
  2578. </para>
  2579. <screen>
  2580. <phrase role="commit-message">Resolve some actual regressions in <tag>date</tag> output spotted by more recent versions of epubcheck</phrase>
  2581. </screen>
  2582. </listitem>
  2583. <listitem>
  2584. <para>
  2585. <literal>Keith Fahlgren: docbook.xsl</literal>
  2586. </para>
  2587. <screen>
  2588. <phrase role="commit-message">Updated <tag>mediaobject</tag> selection code that better uses roles (when available); based on contributons by Glenn McDonald</phrase>
  2589. </screen>
  2590. </listitem>
  2591. <listitem>
  2592. <para>
  2593. <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
  2594. </para>
  2595. <screen>
  2596. <phrase role="commit-message">Ensure that NCX documents are always outputted with a default namespace
  2597. to prevent problems with the kindlegen machinery</phrase>
  2598. </screen>
  2599. </listitem>
  2600. <listitem>
  2601. <para>
  2602. <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/partintro.xml; docbook.x&#x22EF;</literal>
  2603. </para>
  2604. <screen>
  2605. <phrase role="commit-message">Adding support for partintros with sect2s, 3s, etc</phrase>
  2606. </screen>
  2607. </listitem>
  2608. <listitem>
  2609. <para>
  2610. <literal>Keith Fahlgren: docbook.xsl</literal>
  2611. </para>
  2612. <screen>
  2613. <phrase role="commit-message">Adding param to workaround horrific ADE bug with the inability to process &lt;br&gt;</phrase>
  2614. </screen>
  2615. </listitem>
  2616. <listitem>
  2617. <para>
  2618. <literal>Keith Fahlgren: docbook.xsl</literal>
  2619. </para>
  2620. <screen>
  2621. <phrase role="commit-message">Add support for <tag>authorgroup</tag>/<tag>author</tag> in OPF metadata (via Michael Wiedmann)</phrase>
  2622. </screen>
  2623. </listitem>
  2624. <listitem>
  2625. <para>
  2626. <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb</literal>
  2627. </para>
  2628. <screen>
  2629. <phrase role="commit-message">Remove &lt;b&gt; and &lt;i&gt; elements "discouraged in favor of style sheets" from
  2630. XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
  2631. Fixes bug #2873153: No &lt;b&gt; and &lt;i&gt; tags in XHTML/EPUB
  2632. Added regression to EPUB specs:</phrase>
  2633. </screen>
  2634. </listitem>
  2635. <listitem>
  2636. <para>
  2637. <literal>Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf; docbook.xsl; bi&#x22EF;</literal>
  2638. </para>
  2639. <screen>
  2640. <phrase role="commit-message">This resolves bug #2873142, Please add support for multiple embedded fonts
  2641. If you navigate to a checkout of DocBook-XSL and go to:
  2642. xsl/epub/bin/spec/files
  2643. You can now run the following <tag>command</tag>:
  2644. ../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
  2645. -s test_cust.xsl orm.book.001.xml
  2646. In dbtoepub, the following option can be used more than once:
  2647. -f, --font [OTF FILE] Embed OTF FILE in .epub.
  2648. The underlying stylesheet now accepts a comma-separated list of font file
  2649. names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
  2650. The runnable EPUB spec now includes:
  2651. - should be valid .epub after including more than one embedded font</phrase>
  2652. </screen>
  2653. </listitem>
  2654. <listitem>
  2655. <para>
  2656. <literal>Keith Fahlgren: docbook.xsl</literal>
  2657. </para>
  2658. <screen>
  2659. <phrase role="commit-message">Improve the selection of <tag>cover</tag> images when working in DocBook 4.x land (work in progress)</phrase>
  2660. </screen>
  2661. </listitem>
  2662. <listitem>
  2663. <para>
  2664. <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
  2665. </para>
  2666. <screen>
  2667. <phrase role="commit-message">Improve the quality of the OPF spine regression by ensuring that the spine
  2668. elements for deeply nested refentries are in order and adjacent to their
  2669. opening wrapper XHTML chunk.</phrase>
  2670. </screen>
  2671. </listitem>
  2672. <listitem>
  2673. <para>
  2674. <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/orm.book.00&#x22EF;</literal>
  2675. </para>
  2676. <screen>
  2677. <phrase role="commit-message">Add more careful handling of refentries to ensure that they always appear in the opf:spine.
  2678. This was only a problem when refentries were pushed deep into the hierarchy (like inside
  2679. a <tag>sect2</tag>), but presented navigational problems for many reading systems (despite the
  2680. correct NCX references). This may *not* be the best solution, but attacking a better
  2681. chunking strategy for refentries was too big a nut to crack at this time.</phrase>
  2682. </screen>
  2683. </listitem>
  2684. </itemizedlist>
  2685. </sect2>
  2686. <!--end of Epub changes for 1.76.0-->
  2687. <sect2 xml:id="rnV1.76.0_Eclipse">
  2688. <title>Eclipse</title>
  2689. <para>The following changes have been made to the
  2690. <filename>eclipse</filename> code
  2691. since the 1.75.2 release.</para>
  2692. <itemizedlist>
  2693. <listitem>
  2694. <para>
  2695. <literal>Mauritz Jeanson: eclipse3.xsl</literal>
  2696. </para>
  2697. <screen>
  2698. <phrase role="commit-message">Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x
  2699. architecture. The main difference to the older format is that metadata is stored in a separate
  2700. <parameter>manifest</parameter> file. The module imports and extends the existing eclipse.xsl module. Based on code
  2701. contributed in patch #2624668.</phrase>
  2702. </screen>
  2703. </listitem>
  2704. </itemizedlist>
  2705. </sect2>
  2706. <!--end of Eclipse changes for 1.76.0-->
  2707. <sect2 xml:id="rnV1.76.0_Params">
  2708. <title>Params</title>
  2709. <para>The following changes have been made to the
  2710. <filename>params</filename> code
  2711. since the 1.75.2 release.</para>
  2712. <itemizedlist>
  2713. <listitem>
  2714. <para>
  2715. <literal>Robert Stayton: draft.watermark.image.xml</literal>
  2716. </para>
  2717. <screen>
  2718. <phrase role="commit-message">Fix bug 2922488 <parameter>draft.watermark.image</parameter> pointing to web resource.
  2719. Now the value is images/draft.png, and may require customization
  2720. for local resolution.</phrase>
  2721. </screen>
  2722. </listitem>
  2723. <listitem>
  2724. <para>
  2725. <literal>Mauritz Jeanson: equation.number.properties.xml</literal>
  2726. </para>
  2727. <screen>
  2728. <phrase role="commit-message">Corrected <tag>refpurpose</tag>.</phrase>
  2729. </screen>
  2730. </listitem>
  2731. <listitem>
  2732. <para>
  2733. <literal>Norman Walsh: paper.type.xml</literal>
  2734. </para>
  2735. <screen>
  2736. <phrase role="commit-message">Added USlegal and USlegallandscape paper types.</phrase>
  2737. </screen>
  2738. </listitem>
  2739. <listitem>
  2740. <para>
  2741. <literal>Jirka Kosek: highlight.xslthl.config.xml</literal>
  2742. </para>
  2743. <screen>
  2744. <phrase role="commit-message">Added note about specifying location as URL</phrase>
  2745. </screen>
  2746. </listitem>
  2747. <listitem>
  2748. <para>
  2749. <literal>Robert Stayton: docbook.css.source.xml; generate.css.header.xml; custom.css.source.xml; ma&#x22EF;</literal>
  2750. </para>
  2751. <screen>
  2752. <phrase role="commit-message">Params to support generated CSS files.</phrase>
  2753. </screen>
  2754. </listitem>
  2755. <listitem>
  2756. <para>
  2757. <literal>Robert Stayton: equation.number.properties.xml</literal>
  2758. </para>
  2759. <screen>
  2760. <phrase role="commit-message">New attribute set for numbers appearing next to equations.</phrase>
  2761. </screen>
  2762. </listitem>
  2763. </itemizedlist>
  2764. </sect2>
  2765. <!--end of Params changes for 1.76.0-->
  2766. <sect2 xml:id="rnV1.76.0_XSL-Xalan">
  2767. <title>XSL-Xalan</title>
  2768. <para>The following changes have been made to the
  2769. <filename>xsl-xalan</filename> code
  2770. since the 1.75.2 release.</para>
  2771. <itemizedlist>
  2772. <listitem>
  2773. <para>
  2774. <literal>dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml</literal>
  2775. </para>
  2776. <screen>
  2777. <phrase role="commit-message">Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.</phrase>
  2778. </screen>
  2779. </listitem>
  2780. </itemizedlist>
  2781. </sect2>
  2782. <!--end of XSL-Xalan changes for 1.76.0-->
  2783. </sect1>
  2784. <sect1 xml:id="rn_V1.75.2">
  2785. <title>Release Notes: 1.75.2</title>
  2786. <para>The following is a list of changes that have been made
  2787. since the 1.75.1 release.</para>
  2788. <sect2 xml:id="rn_V1.75.2_Gentext">
  2789. <title>Gentext</title>
  2790. <para>The following changes have been made to the
  2791. <filename>gentext</filename> code
  2792. since the 1.75.1 release.</para>
  2793. <itemizedlist>
  2794. <listitem>
  2795. <para><literal>dleidert: locale/ja.xml</literal></para><screen><phrase role="commit-message">Improved Japanese translation for Note(s). Closes bug #2823965.</phrase></screen>
  2796. </listitem>
  2797. <listitem>
  2798. <para><literal>dleidert: locale/pl.xml</literal></para><screen><phrase role="commit-message">Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.</phrase></screen>
  2799. </listitem>
  2800. <listitem>
  2801. <para><literal>Robert Stayton: locale/ja.xml</literal></para><screen><phrase role="commit-message">Fix translation of "<tag>index</tag>", per bug report 2796064.</phrase></screen>
  2802. </listitem>
  2803. <listitem>
  2804. <para><literal>Robert Stayton: locale/is.xml</literal></para><screen><phrase role="commit-message">New Icelandic locale file.</phrase></screen>
  2805. </listitem>
  2806. </itemizedlist>
  2807. </sect2><!--end of Gentext changes for 1.75.2-->
  2808. <sect2 xml:id="rn_V1.75.2_Common">
  2809. <title>Common</title>
  2810. <para>The following changes have been made to the
  2811. <filename>common</filename> code
  2812. since the 1.75.1 release.</para>
  2813. <itemizedlist>
  2814. <listitem>
  2815. <para><literal>Norman Walsh: stripns.xsl</literal></para><screen><phrase role="commit-message">Support more downconvert cases</phrase></screen>
  2816. </listitem>
  2817. <listitem>
  2818. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Make sure <tag>title</tag> inside <tag>info</tag> is used if no other <tag>title</tag>.</phrase></screen>
  2819. </listitem>
  2820. </itemizedlist>
  2821. </sect2><!--end of Common changes for 1.75.2-->
  2822. <sect2 xml:id="rn_V1.75.2_FO">
  2823. <title>FO</title>
  2824. <para>The following changes have been made to the
  2825. <filename>fo</filename> code
  2826. since the 1.75.1 release.</para>
  2827. <itemizedlist>
  2828. <listitem>
  2829. <para><literal>Robert Stayton: pi.xsl</literal></para><screen><phrase role="commit-message">Turn off dbfo-need for <parameter>fop1.extensions</parameter> also, per bug #2816141.</phrase></screen>
  2830. </listitem>
  2831. </itemizedlist>
  2832. </sect2><!--end of FO changes for 1.75.2-->
  2833. <sect2 xml:id="rn_V1.75.2_HTML">
  2834. <title>HTML</title>
  2835. <para>The following changes have been made to the
  2836. <filename>html</filename> code
  2837. since the 1.75.1 release.</para>
  2838. <itemizedlist>
  2839. <listitem>
  2840. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Output "<tag>Copyright</tag>" heading in XHTML too.</phrase></screen>
  2841. </listitem>
  2842. <listitem>
  2843. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added stylesheet.result.type test for <tag>copyright</tag>. Closes bug #2813289.</phrase></screen>
  2844. </listitem>
  2845. <listitem>
  2846. <para><literal>Norman Walsh: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Remove ambiguity wrt @span, @rowspan, and @colspan</phrase></screen>
  2847. </listitem>
  2848. </itemizedlist>
  2849. </sect2><!--end of HTML changes for 1.75.2-->
  2850. <sect2 xml:id="rn_V1.75.2_Manpages">
  2851. <title>Manpages</title>
  2852. <para>The following changes have been made to the
  2853. <filename>manpages</filename> code
  2854. since the 1.75.1 release.</para>
  2855. <itemizedlist>
  2856. <listitem>
  2857. <para><literal>Mauritz Jeanson: endnotes.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() for ulink content. Closes bug #2793877.</phrase></screen>
  2858. </listitem>
  2859. <listitem>
  2860. <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added stylesheet.result.type test for <tag>copyright</tag>. Closes bug #2813289.</phrase></screen>
  2861. </listitem>
  2862. </itemizedlist>
  2863. </sect2><!--end of Manpages changes for 1.75.2-->
  2864. <sect2 xml:id="rn_V1.75.2_Epub">
  2865. <title>Epub</title>
  2866. <para>The following changes have been made to the
  2867. <filename>epub</filename> code
  2868. since the 1.75.1 release.</para>
  2869. <itemizedlist>
  2870. <listitem>
  2871. <para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb</literal></para><screen><phrase role="commit-message">Corrected bugs caused by path and file assumptions were not met</phrase></screen>
  2872. </listitem>
  2873. <listitem>
  2874. <para><literal>Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly</phrase></screen>
  2875. </listitem>
  2876. </itemizedlist>
  2877. </sect2><!--end of Epub changes for 1.75.2-->
  2878. <sect2 xml:id="rn_V1.75.2_Profiling">
  2879. <title>Profiling</title>
  2880. <para>The following changes have been made to the
  2881. <filename>profiling</filename> code
  2882. since the 1.75.1 release.</para>
  2883. <itemizedlist>
  2884. <listitem>
  2885. <para><literal>Robert Stayton: profile.xsl</literal></para><screen><phrase role="commit-message">Fix bug 2815493 missing <parameter>exsl.node.set.available</parameter> parameter.</phrase></screen>
  2886. </listitem>
  2887. </itemizedlist>
  2888. </sect2><!--end of Profiling changes for 1.75.2-->
  2889. <sect2 xml:id="rn_V1.75.2_XSL-Saxon">
  2890. <title>XSL-Saxon</title>
  2891. <para>The following changes have been made to the
  2892. <filename>xsl-saxon</filename> code
  2893. since the 1.75.1 release.</para>
  2894. <itemizedlist>
  2895. <listitem>
  2896. <para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/nwalsh/saxon/Colum&#x22EF;</literal></para><screen><phrase role="commit-message">Added fixes so that colgroups in the XHTML namespace are processed properly.</phrase></screen>
  2897. </listitem>
  2898. </itemizedlist>
  2899. </sect2><!--end of XSL-Saxon changes for 1.75.2-->
  2900. <sect2 xml:id="rn_V1.75.2_XSL-Xalan">
  2901. <title>XSL-Xalan</title>
  2902. <para>The following changes have been made to the
  2903. <filename>xsl-xalan</filename> code
  2904. since the 1.75.1 release.</para>
  2905. <itemizedlist>
  2906. <listitem>
  2907. <para><literal>Mauritz Jeanson: nbproject/project.xml</literal></para><screen><phrase role="commit-message">Added missing NetBeans configuration.</phrase></screen>
  2908. </listitem>
  2909. </itemizedlist>
  2910. </sect2><!--end of XSL-Xalan changes for 1.75.2-->
  2911. </sect1>
  2912. <sect1 xml:id="rn_V1.75.1">
  2913. <title>Release Notes: 1.75.1</title>
  2914. <para>This release includes bug fixes.</para>
  2915. <para>The following is a list of changes that have been made since the 1.75.0 release.</para>
  2916. <sect2 xml:id="rn_V1.75.1_FO">
  2917. <title>FO</title>
  2918. <para>The following changes have been made to the <filename>fo</filename> code since the 1.75.0 release.</para>
  2919. <itemizedlist>
  2920. <listitem>
  2921. <para><literal>Keith Fahlgren: block.xsl</literal></para><screen><phrase role="commit-message">Switching to em dash for character before <tag>attribution</tag> in <tag>epigraph</tag>; resolves Bug #2793878</phrase></screen>
  2922. </listitem>
  2923. <listitem>
  2924. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789947, id attribute missing on <tag>simplelist</tag> fo output.</phrase></screen>
  2925. </listitem>
  2926. </itemizedlist>
  2927. </sect2><!--end of FO changes for 1.75.1-->
  2928. <sect2 xml:id="rn_V1.75.1_HTML">
  2929. <title>HTML</title>
  2930. <para>The following changes have been made to the
  2931. <filename>html</filename> code
  2932. since the 1.75.0 release.</para>
  2933. <itemizedlist>
  2934. <listitem>
  2935. <para><literal>Keith Fahlgren: block.xsl</literal></para><screen><phrase role="commit-message">Switching to em dash for character before <tag>attribution</tag> in <tag>epigraph</tag>; resolves Bug #2793878</phrase></screen>
  2936. </listitem>
  2937. <listitem>
  2938. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789678: apply-templates line accidentally deleted.</phrase></screen>
  2939. </listitem>
  2940. </itemizedlist>
  2941. </sect2><!--end of HTML changes for 1.75.1-->
  2942. <sect2 xml:id="rn_V1.75.1_Epub">
  2943. <title>Epub</title>
  2944. <para>The following changes have been made to the
  2945. <filename>epub</filename> code
  2946. since the 1.75.0 release.</para>
  2947. <itemizedlist>
  2948. <listitem>
  2949. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017</phrase></screen>
  2950. </listitem>
  2951. <listitem>
  2952. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/onegraphic.xinclude.xml;&#x22EF;</literal></para><screen><phrase role="commit-message">Another attempt at flexible named entity and XInclude processing</phrase></screen>
  2953. </listitem>
  2954. <listitem>
  2955. <para><literal>Keith Fahlgren: bin/lib/docbook.rb</literal></para><screen><phrase role="commit-message">Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.</phrase></screen>
  2956. </listitem>
  2957. </itemizedlist>
  2958. </sect2><!--end of Epub changes for 1.75.1-->
  2959. <sect2 xml:id="rn_V1.75.1_Params">
  2960. <title>Params</title>
  2961. <para>The following changes have been made to the
  2962. <filename>params</filename> code
  2963. since the 1.75.0 release.</para>
  2964. <itemizedlist>
  2965. <listitem>
  2966. <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated documentation to reflect changes made in r8419.</phrase></screen>
  2967. </listitem>
  2968. </itemizedlist>
  2969. </sect2><!--end of Params changes for 1.75.1-->
  2970. </sect1>
  2971. <sect1 xml:id="V1.75.0">
  2972. <title>Release Notes: 1.75.0</title>
  2973. <para>This release includes important bug fixes and adds the following
  2974. significant feature changes:
  2975. <variablelist>
  2976. <varlistentry>
  2977. <term>Gentext</term>
  2978. <listitem><para>Modifications to translations have been made. </para></listitem>
  2979. </varlistentry>
  2980. <varlistentry>
  2981. <term>Common</term>
  2982. <listitem>
  2983. <para>Added support for some format properties on tables using
  2984. HTML <tag>table</tag> markup. </para>
  2985. <para>Added two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
  2986. and numbered questions can be distinguished. Satisfies
  2987. Feature Request #1539045.</para>
  2988. <para>Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
  2989. similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
  2990. any dedications.</para>
  2991. </listitem>
  2992. </varlistentry>
  2993. <varlistentry>
  2994. <term>FO</term>
  2995. <listitem>
  2996. <para>The inclusion of highlighting code has been simplified.</para>
  2997. <para>Add support for pgwide on informal objects.</para>
  2998. <para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. Closes FR #1792326.</para>
  2999. <para>Add support for more dbfo processing instructions.</para>
  3000. <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
  3001. <para>Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</para>
  3002. <para>Add support for writing-mode="rl-tb" (right-to-left) in FO outputs. </para>
  3003. <para>Add <parameter>writing.mode</parameter> param for FO output.</para>
  3004. </listitem>
  3005. </varlistentry>
  3006. <varlistentry>
  3007. <term>HTML</term>
  3008. <listitem>
  3009. <para>Convert all calls to class.attribute to calls to common.html.attributes to support dir, lang, and <tag>title</tag> attributes in html output for all elements. Fulfills feature request #1993833.</para>
  3010. <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
  3011. <para>Add new param <parameter>index.links.to.section</parameter>.</para>
  3012. <para>Add support for the new <parameter>index.links.to.section</parameter> param which permits precise links to indexterms in HTML output rather than to the <tag>section</tag> <tag>title</tag>.</para>
  3013. </listitem>
  3014. </varlistentry>
  3015. <varlistentry>
  3016. <term>ePub</term>
  3017. <listitem>
  3018. <para>Slightly more nuanced handling of <tag>imageobject</tag> alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.</para>
  3019. <para>Added a colon after an <tag>abstract</tag>/<tag>title</tag> when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)</para>
  3020. <para>Added DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</para>
  3021. <para>Added DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</para>
  3022. <para>Added DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</para>
  3023. <para>Added --output option to dbtoepub based on user request</para>
  3024. </listitem>
  3025. </varlistentry>
  3026. <varlistentry>
  3027. <term>HTMLHelp</term>
  3028. <listitem>
  3029. <para>Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</para></listitem>
  3030. </varlistentry>
  3031. <varlistentry>
  3032. <term>Params</term>
  3033. <listitem>
  3034. <para>Add default setting for @rules attribute on HTML markup tables.</para>
  3035. <para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X. Closes FR #1792326.</para>
  3036. <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
  3037. <para>Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.</para>
  3038. <para>Add param to control whether an <tag>index</tag> <tag>entry</tag> links to a <tag>section</tag> <tag>title</tag> or to the precise location of the <tag>indexterm</tag>.</para>
  3039. <para>New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</para>
  3040. <para>New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</para>
  3041. <para>Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</para>
  3042. </listitem>
  3043. </varlistentry>
  3044. <varlistentry>
  3045. <term>Highlighting</term>
  3046. <listitem>
  3047. <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
  3048. </listitem>
  3049. </varlistentry>
  3050. </variablelist>
  3051. </para>
  3052. <para>The following is a list of changes that have been made
  3053. since the 1.74.3 release.</para>
  3054. <sect2 xml:id="rn_V1.75.0_Gentext">
  3055. <title>Gentext</title>
  3056. <para>The following changes have been made to the
  3057. <filename>gentext</filename> code
  3058. since the 1.74.3 release.</para>
  3059. <itemizedlist>
  3060. <listitem>
  3061. <para><literal>Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml</literal></para><screen><phrase role="commit-message">Check in translations of <tag>Legalnotice</tag> submitted on mailing list.</phrase></screen>
  3062. </listitem>
  3063. <listitem>
  3064. <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Fix spelling errors in <tag>Acknowledgements</tag> entries.</phrase></screen>
  3065. </listitem>
  3066. <listitem>
  3067. <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Check in translations for 4 elements submitted through docbook-apps
  3068. message of 14 April 2009.</phrase></screen>
  3069. </listitem>
  3070. <listitem>
  3071. <para><literal>David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml; locale/gl.xml; l&#x22EF;</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
  3072. </listitem>
  3073. <listitem>
  3074. <para><literal>Robert Stayton: Makefile</literal></para><screen><phrase role="commit-message">Check in fixes for DSSSL gentext targets from submitted patch #1689633.</phrase></screen>
  3075. </listitem>
  3076. <listitem>
  3077. <para><literal>Robert Stayton: locale/uk.xml</literal></para><screen><phrase role="commit-message">Check in major update submitted with bug report #2008524.</phrase></screen>
  3078. </listitem>
  3079. <listitem>
  3080. <para><literal>Robert Stayton: locale/zh_tw.xml</literal></para><screen><phrase role="commit-message">Check in fix to Note string submitted in bug #2441051.</phrase></screen>
  3081. </listitem>
  3082. <listitem>
  3083. <para><literal>Robert Stayton: locale/ru.xml</literal></para><screen><phrase role="commit-message">Checkin typo fix submitted in bug #2453406.</phrase></screen>
  3084. </listitem>
  3085. </itemizedlist>
  3086. </sect2><!--end of Gentext changes for 1.75.0-->
  3087. <sect2 xml:id="rn_V1.75.0_Common">
  3088. <title>Common</title>
  3089. <para>The following changes have been made to the
  3090. <filename>common</filename> code
  3091. since the 1.74.3 release.</para>
  3092. <itemizedlist>
  3093. <listitem>
  3094. <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Fix extra generated space when xrefstyle includes 'nopage'.</phrase></screen>
  3095. </listitem>
  3096. <listitem>
  3097. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
  3098. HTML <tag>table</tag> markup. These include:
  3099. - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
  3100. - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
  3101. - align attribute on <tag>td</tag> and <tag>th</tag>
  3102. - valign attribute on <tag>td</tag> and <tag>th</tag>
  3103. - colspan on <tag>td</tag> and <tag>th</tag>
  3104. - rowspan on <tag>td</tag> and <tag>th</tag>
  3105. - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
  3106. </listitem>
  3107. <listitem>
  3108. <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Add placeholder template to massage <tag>olink</tag> hot text to make
  3109. customization easier, per Feature Request 1828608.</phrase></screen>
  3110. </listitem>
  3111. <listitem>
  3112. <para><literal>Robert Stayton: targets.xsl</literal></para><screen><phrase role="commit-message">Add support for collecting <tag>olink</tag> targets from a <tag>glossary</tag>
  3113. generated from a <parameter>glossary.collection</parameter>.</phrase></screen>
  3114. </listitem>
  3115. <listitem>
  3116. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="title.markup".</phrase></screen>
  3117. </listitem>
  3118. <listitem>
  3119. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add match on <tag>info</tag>/<tag>title</tag> in title.markup templates where missing.</phrase></screen>
  3120. </listitem>
  3121. <listitem>
  3122. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Changed "ancestor::<tag>title</tag>" to "(ancestor::<tag>title</tag> and (@id or @xml:id))".
  3123. This enables proper formatting of inline elements in titles in TOCs,
  3124. as long as these inlines don't have id or xml:id attributes.</phrase></screen>
  3125. </listitem>
  3126. <listitem>
  3127. <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
  3128. and numbered questions can be distinguished. Satisfies
  3129. Feature Request #1539045.</phrase></screen>
  3130. </listitem>
  3131. <listitem>
  3132. <para><literal>Robert Stayton: stripns.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Convert function-available(exsl:node-set) to use the new param
  3133. so Xalan bug is isolated.</phrase></screen>
  3134. </listitem>
  3135. <listitem>
  3136. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added fixes for bugs #2112656 and #1759205:
  3137. 1. Reverted mistaken commits r7485 and r7523.
  3138. 2. Updated the template with match="<tag>link</tag>" and mode="no.anchor.mode" so that
  3139. @endterm is used if it exists and if the <tag>link</tag> has no content.</phrase></screen>
  3140. </listitem>
  3141. <listitem>
  3142. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
  3143. similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
  3144. any dedications.</phrase></screen>
  3145. </listitem>
  3146. <listitem>
  3147. <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #2018717 <parameter>use.local.olink.style</parameter> uses wrong gentext context.</phrase></screen>
  3148. </listitem>
  3149. <listitem>
  3150. <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
  3151. </listitem>
  3152. <listitem>
  3153. <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1669654 Broken output if <tag>copyright</tag> &lt;<tag>year</tag>&gt; contains a range.</phrase></screen>
  3154. </listitem>
  3155. <listitem>
  3156. <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Fix bug in labelling <tag>figure</tag> inside <tag>appendix</tag> inside <tag>article</tag> inside <tag>book</tag>.</phrase></screen>
  3157. </listitem>
  3158. </itemizedlist>
  3159. </sect2><!--end of Common changes for 1.75.0-->
  3160. <sect2 xml:id="rn_V1.75.0_FO">
  3161. <title>FO</title>
  3162. <para>The following changes have been made to the
  3163. <filename>fo</filename> code
  3164. since the 1.74.3 release.</para>
  3165. <itemizedlist>
  3166. <listitem>
  3167. <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
  3168. </listitem>
  3169. <listitem>
  3170. <para><literal>Robert Stayton: fop1.xsl</literal></para><screen><phrase role="commit-message">Add the new fop extensions namespace declaration, in case FOP
  3171. extension functions are used.</phrase></screen>
  3172. </listitem>
  3173. <listitem>
  3174. <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Add support for pgwide on informal objects.</phrase></screen>
  3175. </listitem>
  3176. <listitem>
  3177. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixed spurious closing <tag>quote</tag> on line 134.</phrase></screen>
  3178. </listitem>
  3179. <listitem>
  3180. <para><literal>Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">Convert function-available for node-set() to use
  3181. new $exsl.node.set.available param in test.</phrase></screen>
  3182. </listitem>
  3183. <listitem>
  3184. <para><literal>David Cramer: xref.xsl</literal></para><screen><phrase role="commit-message">Suppress extra space after <tag>xref</tag> when xrefstyle='select: <tag>label</tag> nopage' (#2740472)</phrase></screen>
  3185. </listitem>
  3186. <listitem>
  3187. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
  3188. </listitem>
  3189. <listitem>
  3190. <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
  3191. </listitem>
  3192. <listitem>
  3193. <para><literal>Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
  3194. HTML <tag>table</tag> markup. These include:
  3195. - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
  3196. - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
  3197. - align attribute on <tag>td</tag> and <tag>th</tag>
  3198. - valign attribute on <tag>td</tag> and <tag>th</tag>
  3199. - colspan on <tag>td</tag> and <tag>th</tag>
  3200. - rowspan on <tag>td</tag> and <tag>th</tag>
  3201. - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
  3202. </listitem>
  3203. <listitem>
  3204. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support bgcolor in <tag>td</tag> and <tag>th</tag>
  3205. elements in HTML <tag>table</tag> markup.</phrase></screen>
  3206. </listitem>
  3207. <listitem>
  3208. <para><literal>Robert Stayton: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Add support for colspan and rowspan and bgcolor in <tag>td</tag> and <tag>th</tag>
  3209. elements in HTML <tag>table</tag> markup.</phrase></screen>
  3210. </listitem>
  3211. <listitem>
  3212. <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Fix working of page-master left and right margins.</phrase></screen>
  3213. </listitem>
  3214. <listitem>
  3215. <para><literal>Mauritz Jeanson: param.xweb; param.ent; fop1.xsl</literal></para><screen><phrase role="commit-message">Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
  3216. </listitem>
  3217. <listitem>
  3218. <para><literal>Robert Stayton: table.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo row-height processing instruction, like that in dbhtml.</phrase></screen>
  3219. </listitem>
  3220. <listitem>
  3221. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo keep-together processing instruction for
  3222. entire list instances.</phrase></screen>
  3223. </listitem>
  3224. <listitem>
  3225. <para><literal>Robert Stayton: lists.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Add support fo dbfo keep-together processing instruction to
  3226. more blocks like list items and paras.</phrase></screen>
  3227. </listitem>
  3228. <listitem>
  3229. <para><literal>Robert Stayton: lists.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</phrase></screen>
  3230. </listitem>
  3231. <listitem>
  3232. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
  3233. </listitem>
  3234. <listitem>
  3235. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="xref-to".</phrase></screen>
  3236. </listitem>
  3237. <listitem>
  3238. <para><literal>Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Implement simple.xlink for <tag>glosssee</tag> and <tag>glossseealso</tag> so they can use
  3239. other types of linking besides otherterm.</phrase></screen>
  3240. </listitem>
  3241. <listitem>
  3242. <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.</phrase></screen>
  3243. </listitem>
  3244. <listitem>
  3245. <para><literal>Robert Stayton: titlepage.xsl</literal></para><screen><phrase role="commit-message">For the <tag>book</tag> <tag>title</tag> templates, I changed <tag>info</tag>/<tag>title</tag> to <tag>book</tag>/<tag>info</tag>/<tag>title</tag>
  3246. so other element's titles will not be affected.</phrase></screen>
  3247. </listitem>
  3248. <listitem>
  3249. <para><literal>Robert Stayton: xref.xsl; verbatim.xsl</literal></para><screen><phrase role="commit-message">Use param <parameter>exsl.node.set.available</parameter> to test for <tag>function</tag>.</phrase></screen>
  3250. </listitem>
  3251. <listitem>
  3252. <para><literal>Robert Stayton: param.xweb; param.ent; footnote.xsl</literal></para><screen><phrase role="commit-message">Start using new param <parameter>exsl.node.set.available</parameter> to work around Xalan bug.</phrase></screen>
  3253. </listitem>
  3254. <listitem>
  3255. <para><literal>Robert Stayton: titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add comment on use of t:predicate for <tag>editor</tag> to prevent
  3256. extra processing of multiple editors. Fixes bug 2687842.</phrase></screen>
  3257. </listitem>
  3258. <listitem>
  3259. <para><literal>Robert Stayton: xref.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">An <tag>indexterm</tag> <tag>primary</tag>, <tag>secondary</tag>, or <tag>tertiary</tag> element with an id or xml:id
  3260. now outputs that ID, so that <tag>index</tag> entries can be cross referenced to.</phrase></screen>
  3261. </listitem>
  3262. <listitem>
  3263. <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
  3264. Closes bug #1623468.</phrase></screen>
  3265. </listitem>
  3266. <listitem>
  3267. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add template with match on <tag>indexterm</tag> in mode="xref-to" to fix bug 2102592.</phrase></screen>
  3268. </listitem>
  3269. <listitem>
  3270. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Now <tag>xref</tag> to <tag>qandaentry</tag> will use the <tag>label</tag> element in a <tag>question</tag> for
  3271. the <tag>link</tag> text if it has one.</phrase></screen>
  3272. </listitem>
  3273. <listitem>
  3274. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add id if specified from @id to output for <tag>quote</tag> and <tag>phrase</tag> so
  3275. they can be <tag>xref</tag>'ed to.</phrase></screen>
  3276. </listitem>
  3277. <listitem>
  3278. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>xref</tag> to <tag>phrase</tag>, <tag>simpara</tag>, <tag>anchor</tag>, and <tag>quote</tag>.
  3279. This assumes the <tag>author</tag> specifies something using xrefstyle since
  3280. the elements don't have ordinary <tag>link</tag> text.</phrase></screen>
  3281. </listitem>
  3282. <listitem>
  3283. <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Fix bug in new <tag>toc</tag> templates.</phrase></screen>
  3284. </listitem>
  3285. <listitem>
  3286. <para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl; titlepage.templates&#x22EF;</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
  3287. similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
  3288. any dedications.</phrase></screen>
  3289. </listitem>
  3290. <listitem>
  3291. <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Rewrite <tag>toc</tag> templates to support an empty <tag>toc</tag> or populated <tag>toc</tag>
  3292. in all permitted contexts. Same for lot elements.
  3293. This fixes bug #1595969 for FO outputs.</phrase></screen>
  3294. </listitem>
  3295. <listitem>
  3296. <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fix indents for <tag>seealsoie</tag> so they are consistent.</phrase></screen>
  3297. </listitem>
  3298. <listitem>
  3299. <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Removed duplicate (<parameter>monospace.font.family</parameter>).</phrase></screen>
  3300. </listitem>
  3301. <listitem>
  3302. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>glossentry.list.item.properties</parameter>.</phrase></screen>
  3303. </listitem>
  3304. <listitem>
  3305. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>monospace.verbatim.font.width</parameter> param to support @width on <tag>programlisting</tag>.</phrase></screen>
  3306. </listitem>
  3307. <listitem>
  3308. <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Put <tag>programlisting</tag> in fo:block-container with writing-mode="lr-tb"
  3309. when text direction is right to left because all program languages
  3310. are left-to-right.</phrase></screen>
  3311. </listitem>
  3312. <listitem>
  3313. <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</phrase></screen>
  3314. </listitem>
  3315. <listitem>
  3316. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1973585 <tag>xref</tag> to <tag>para</tag> with xrefstyle not handled correctly.</phrase></screen>
  3317. </listitem>
  3318. <listitem>
  3319. <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
  3320. Support in <tag>book</tag>/part remains to be added.</phrase></screen>
  3321. </listitem>
  3322. <listitem>
  3323. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
  3324. </listitem>
  3325. <listitem>
  3326. <para><literal>Robert Stayton: fo.xsl</literal></para><screen><phrase role="commit-message">Add writing-mode="tb-rl" as well since some XSL-FO processors support it.</phrase></screen>
  3327. </listitem>
  3328. <listitem>
  3329. <para><literal>Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
  3330. Changed instances of margin-left to margin-{$direction.align.start}
  3331. and margin-right to margin-{$direction.align.end}. Those direction.align
  3332. params are computed from the writing mode value in each locale's
  3333. gentext key named 'writing-mode', introduced in 1.74.3 to add
  3334. right-to-left support to HTML outputs.</phrase></screen>
  3335. </listitem>
  3336. <listitem>
  3337. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</phrase></screen>
  3338. </listitem>
  3339. <listitem>
  3340. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>writing.mode</parameter> param for FO output.</phrase></screen>
  3341. </listitem>
  3342. <listitem>
  3343. <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix bug 1546008: in <tag>qandaentry</tag> in a <tag>TOC</tag>, use its blockinfo/<tag>titleabbrev</tag> or blockinfo/<tag>title</tag>
  3344. instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
  3345. </listitem>
  3346. <listitem>
  3347. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
  3348. </listitem>
  3349. <listitem>
  3350. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">More tweaking the way that XSLTHL does or does not get called</phrase></screen>
  3351. </listitem>
  3352. <listitem>
  3353. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
  3354. </listitem>
  3355. </itemizedlist>
  3356. </sect2><!--end of FO changes for 1.75.0-->
  3357. <sect2 xml:id="rn_V1.75.0_HTML">
  3358. <title>HTML</title>
  3359. <para>The following changes have been made to the
  3360. <filename>html</filename> code
  3361. since the 1.74.3 release.</para>
  3362. <itemizedlist>
  3363. <listitem>
  3364. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Removed redundant lang and <tag>title</tag> attributes on list element inside
  3365. div element for lists.</phrase></screen>
  3366. </listitem>
  3367. <listitem>
  3368. <para><literal>Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl; sections.xsl; table.xsl;&#x22EF;</literal></para><screen><phrase role="commit-message">Convert all calls to class.attribute to calls to common.html.attributes
  3369. to support dir, lang, and <tag>title</tag> attributes in html output for all elements.
  3370. Fulfills feature request #1993833.</phrase></screen>
  3371. </listitem>
  3372. <listitem>
  3373. <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #2750253 wrong links in list of figures in chunk.html
  3374. when target html is in a subdirectory and dbhtml <tag>filename</tag> used.</phrase></screen>
  3375. </listitem>
  3376. <listitem>
  3377. <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
  3378. </listitem>
  3379. <listitem>
  3380. <para><literal>Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl; chunk-changebars.xsl; autoidx&#x22EF;</literal></para><screen><phrase role="commit-message">Convert function-available for node-set() to use
  3381. new $exsl.node.set.available param in test.</phrase></screen>
  3382. </listitem>
  3383. <listitem>
  3384. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
  3385. </listitem>
  3386. <listitem>
  3387. <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
  3388. </listitem>
  3389. <listitem>
  3390. <para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">More elements get common.html.attributes.
  3391. Added locale.html.attributes template which does the lang,
  3392. dir, and <tag>title</tag> attributes, but not the class attribute
  3393. (used on <tag>para</tag>, for example).</phrase></screen>
  3394. </listitem>
  3395. <listitem>
  3396. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Replace more <tag>literal</tag> class atts with mode="class.attribute" to support
  3397. easier customization.</phrase></screen>
  3398. </listitem>
  3399. <listitem>
  3400. <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">Support olinking in <tag>glosssee</tag> and <tag>glossseealso</tag>.</phrase></screen>
  3401. </listitem>
  3402. <listitem>
  3403. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
  3404. </listitem>
  3405. <listitem>
  3406. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="xref-to".</phrase></screen>
  3407. </listitem>
  3408. <listitem>
  3409. <para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Added template named common.html.attributes to output
  3410. class, <tag>title</tag>, lang, and dir for most elements.
  3411. Started adding it to some list and block elements.</phrase></screen>
  3412. </listitem>
  3413. <listitem>
  3414. <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
  3415. and numbered questions can be distinguished. Satisfies
  3416. Feature Request #1539045.</phrase></screen>
  3417. </listitem>
  3418. <listitem>
  3419. <para><literal>Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl; chunkfast.xsl; verbatim.x&#x22EF;</literal></para><screen><phrase role="commit-message">Use new param <parameter>exsl.node.set.available</parameter> to test, handles Xalan bug.</phrase></screen>
  3420. </listitem>
  3421. <listitem>
  3422. <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Use named anchors for <tag>primary</tag>, <tag>secondary</tag>, and <tag>tertiary</tag> ids so
  3423. duplicate entries with different ids can still have an id output.</phrase></screen>
  3424. </listitem>
  3425. <listitem>
  3426. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new param <parameter>index.links.to.section</parameter>.</phrase></screen>
  3427. </listitem>
  3428. <listitem>
  3429. <para><literal>Robert Stayton: xref.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">Pass through an id on <tag>primary</tag>, <tag>secondary</tag>, or <tag>tertiary</tag> to
  3430. the <tag>index</tag> <tag>entry</tag>, so that one could <tag>link</tag> to an <tag>index</tag> <tag>entry</tag>.
  3431. You can't <tag>link</tag> to the id on an <tag>indexterm</tag> because that is
  3432. used to place the main <tag>anchor</tag> in the text flow.</phrase></screen>
  3433. </listitem>
  3434. <listitem>
  3435. <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Add support for the new <parameter>index.links.to.section</parameter> param which permits
  3436. precise links to indexterms in HTML output rather than to
  3437. the <tag>section</tag> <tag>title</tag>.</phrase></screen>
  3438. </listitem>
  3439. <listitem>
  3440. <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
  3441. Closes bug #1623468.</phrase></screen>
  3442. </listitem>
  3443. <listitem>
  3444. <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Make sure a <tag>qandaset</tag> has an <tag>anchor</tag>, even when it has no <tag>title</tag>,
  3445. because it may be referenced in a <tag>TOC</tag> or <tag>xref</tag>.
  3446. Before, the <tag>anchor</tag> was output by the <tag>title</tag>, but there was no
  3447. <tag>anchor</tag> if there was no <tag>title</tag>.</phrase></screen>
  3448. </listitem>
  3449. <listitem>
  3450. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add a template for <tag>indexterm</tag> with mode="xref-to" to fix bug 2102592.</phrase></screen>
  3451. </listitem>
  3452. <listitem>
  3453. <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Now <tag>xref</tag> to <tag>qandaentry</tag> will use the <tag>label</tag> element in a <tag>question</tag> for
  3454. the <tag>link</tag> text if it has one.</phrase></screen>
  3455. </listitem>
  3456. <listitem>
  3457. <para><literal>Robert Stayton: qandaset.xsl; html.xsl</literal></para><screen><phrase role="commit-message">Create separate templates for computing <tag>label</tag> of <tag>question</tag> and <tag>answer</tag>
  3458. in a <tag>qandaentry</tag>, so such can be used for the <tag>alt</tag> text of an <tag>xref</tag>
  3459. to a <tag>qandaentry</tag>.</phrase></screen>
  3460. </listitem>
  3461. <listitem>
  3462. <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Now support <tag>xref</tag> to <tag>phrase</tag>, <tag>simpara</tag>, <tag>anchor</tag>, and <tag>quote</tag>,
  3463. most useful when an xrefstyle is used.</phrase></screen>
  3464. </listitem>
  3465. <listitem>
  3466. <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Rewrite <tag>toc</tag> templates to support an empty <tag>toc</tag> or populated <tag>toc</tag>
  3467. in all permitted contexts. Same for lot elements.
  3468. This fixes bug #1595969 for HTML outputs.</phrase></screen>
  3469. </listitem>
  3470. <listitem>
  3471. <para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl; titlepage.templates&#x22EF;</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
  3472. similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
  3473. any dedications.</phrase></screen>
  3474. </listitem>
  3475. <listitem>
  3476. <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Rewrote <tag>primaryie</tag>, <tag>secondaryie</tag> and <tag>tertiaryie</tag> templates to handle
  3477. nesting of elements and <tag>seeie</tag> and <tag>seealsoie</tag>, as reported in
  3478. bug # 1168912.</phrase></screen>
  3479. </listitem>
  3480. <listitem>
  3481. <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix <tag>simplesect</tag> in <tag>toc</tag> problem.</phrase></screen>
  3482. </listitem>
  3483. <listitem>
  3484. <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width per bug report #2012736.</phrase></screen>
  3485. </listitem>
  3486. <listitem>
  3487. <para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787140 HTML tables not handling attributes correctly.</phrase></screen>
  3488. </listitem>
  3489. <listitem>
  3490. <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Move writing-mode param.</phrase></screen>
  3491. </listitem>
  3492. <listitem>
  3493. <para><literal>Keith Fahlgren: refentry.xsl</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
  3494. </listitem>
  3495. <listitem>
  3496. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1945872 to allow passthrough of colwidth values to
  3497. HTML <tag>table</tag> when no <parameter>tablecolumns.extension</parameter> is available and
  3498. when no instance of * appears in the <tag>table</tag>'s colspecs.</phrase></screen>
  3499. </listitem>
  3500. <listitem>
  3501. <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
  3502. Support in <tag>book</tag>/part remains to be added.</phrase></screen>
  3503. </listitem>
  3504. <listitem>
  3505. <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
  3506. </listitem>
  3507. <listitem>
  3508. <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Fix bug 1546008: in <tag>qandaentry</tag> in a <tag>TOC</tag>, use its blockinfo/<tag>titleabbrev</tag> or blockinfo/<tag>title</tag>
  3509. instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
  3510. </listitem>
  3511. <listitem>
  3512. <para><literal>Robert Stayton: chunktoc.xsl</literal></para><screen><phrase role="commit-message">Add support for generating <tag>olink</tag> <tag>database</tag> when using chunktoc.xsl.</phrase></screen>
  3513. </listitem>
  3514. <listitem>
  3515. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
  3516. </listitem>
  3517. <listitem>
  3518. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)</phrase></screen>
  3519. </listitem>
  3520. <listitem>
  3521. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">More tweaking the way that XSLTHL does or does not get called</phrase></screen>
  3522. </listitem>
  3523. <listitem>
  3524. <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
  3525. </listitem>
  3526. </itemizedlist>
  3527. </sect2><!--end of HTML changes for 1.75.0-->
  3528. <sect2 xml:id="rn_V1.75.0_Manpages">
  3529. <title>Manpages</title>
  3530. <para>The following changes have been made to the
  3531. <filename>manpages</filename> code
  3532. since the 1.74.3 release.</para>
  3533. <itemizedlist>
  3534. <listitem>
  3535. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Convert function-available test for node-set() <tag>function</tag> to
  3536. test of $exsl.node.set.available param.</phrase></screen>
  3537. </listitem>
  3538. <listitem>
  3539. <para><literal>Mauritz Jeanson: lists.xsl</literal></para><screen><phrase role="commit-message">Added a template for <tag>bibliolist</tag>. Closes bug #1815916.</phrase></screen>
  3540. </listitem>
  3541. </itemizedlist>
  3542. </sect2><!--end of Manpages changes for 1.75.0-->
  3543. <sect2 xml:id="rn_V1.75.0_Epub">
  3544. <title>ePub</title>
  3545. <para>The following changes have been made to the
  3546. <filename>epub</filename> code
  3547. since the 1.74.3 release.</para>
  3548. <itemizedlist>
  3549. <listitem>
  3550. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/onegraphic.xinclude.xml;&#x22EF;</literal></para><screen><phrase role="commit-message">Slightly more nuanced handling of <tag>imageobject</tag> alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.</phrase></screen>
  3551. </listitem>
  3552. <listitem>
  3553. <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Add a colon after an <tag>abstract</tag>/<tag>title</tag> when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)</phrase></screen>
  3554. </listitem>
  3555. <listitem>
  3556. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/de.xml</literal></para><screen><phrase role="commit-message">Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150</phrase></screen>
  3557. </listitem>
  3558. <listitem>
  3559. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Corrected namespace declarations for <tag>literal</tag> XHTML elements to make them serialize "normally"</phrase></screen>
  3560. </listitem>
  3561. <listitem>
  3562. <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Be a little bit more nuanced about dates</phrase></screen>
  3563. </listitem>
  3564. <listitem>
  3565. <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x&#x22EF;</literal></para><screen><phrase role="commit-message">Add DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</phrase></screen>
  3566. </listitem>
  3567. <listitem>
  3568. <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x&#x22EF;</literal></para><screen><phrase role="commit-message">Add DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</phrase></screen>
  3569. </listitem>
  3570. <listitem>
  3571. <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x&#x22EF;</literal></para><screen><phrase role="commit-message">Add DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</phrase></screen>
  3572. </listitem>
  3573. <listitem>
  3574. <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Check in patch submitted by user to add opf:file-as attribute
  3575. to dc:creator element.</phrase></screen>
  3576. </listitem>
  3577. <listitem>
  3578. <para><literal>Keith Fahlgren: bin/dbtoepub</literal></para><screen><phrase role="commit-message">Adding --output option to dbtoepub based on user request</phrase></screen>
  3579. </listitem>
  3580. <listitem>
  3581. <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb</literal></para><screen><phrase role="commit-message">Cleaning and regularizing the generation of namespaced nodes for OPF, NCX, XHTML and other outputted filetypes (hat <tag>tip</tag> to bobstayton for pointing out the silly, incorrect code)</phrase></screen>
  3582. </listitem>
  3583. <listitem>
  3584. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/refclass.xml</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
  3585. </listitem>
  3586. <listitem>
  3587. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/blockquotepre.xml</literal></para><screen><phrase role="commit-message">Added regression test and fix for XHTML validation problem with &lt;a&gt;s added inside &lt;<tag>blockquote</tag>&gt;; This potentially causes another problem (where something is referenced by has no <tag>anchor</tag>, but someone reporting that should cause the whole &lt;a id='thing'/&gt; thing to be reconsidered with modern browsers in mind.</phrase></screen>
  3588. </listitem>
  3589. </itemizedlist>
  3590. </sect2><!--end of Epub changes for 1.75.0-->
  3591. <sect2 xml:id="rn_V1.75.0_HTMLHelp">
  3592. <title>HTMLHelp</title>
  3593. <para>The following changes have been made to the
  3594. <filename>htmlhelp</filename> code
  3595. since the 1.74.3 release.</para>
  3596. <itemizedlist>
  3597. <listitem>
  3598. <para><literal>Robert Stayton: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</phrase></screen>
  3599. </listitem>
  3600. </itemizedlist>
  3601. </sect2><!--end of HTMLHelp changes for 1.75.0-->
  3602. <sect2 xml:id="rn_V1.75.0_Params">
  3603. <title>Params</title>
  3604. <para>The following changes have been made to the
  3605. <filename>params</filename> code
  3606. since the 1.74.3 release.</para>
  3607. <itemizedlist>
  3608. <listitem>
  3609. <para><literal>Robert Stayton: default.table.rules.xml</literal></para><screen><phrase role="commit-message">Add default setting for @rules attribute on HTML markup tables.</phrase></screen>
  3610. </listitem>
  3611. <listitem>
  3612. <para><literal>Mauritz Jeanson: bookmarks.collapse.xml</literal></para><screen><phrase role="commit-message">Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag>
  3613. of the bookmark tree. When the parameter has a non-zero value (the default),
  3614. only the top-level bookmarks are displayed initially. Otherwise, the whole
  3615. tree of bookmarks is displayed.
  3616. This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
  3617. </listitem>
  3618. <listitem>
  3619. <para><literal>Robert Stayton: variablelist.term.properties.xml</literal></para><screen><phrase role="commit-message">Add new <parameter>variablelist.term.properties</parameter> to format terms, per
  3620. request # 1968513.</phrase></screen>
  3621. </listitem>
  3622. <listitem>
  3623. <para><literal>Robert Stayton: qanda.defaultlabel.xml</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
  3624. and numbered questions can be distinguished. Satisfies
  3625. Feature Request #1539045.</phrase></screen>
  3626. </listitem>
  3627. <listitem>
  3628. <para><literal>Robert Stayton: index.links.to.section.xml</literal></para><screen><phrase role="commit-message">Change default to 1 to match past behavior.</phrase></screen>
  3629. </listitem>
  3630. <listitem>
  3631. <para><literal>Robert Stayton: exsl.node.set.available.xml</literal></para><screen><phrase role="commit-message">Isolate this text for Xalan bug regarding exsl:node-set available.
  3632. If it is ever fixed in Xalan, just fix it here.</phrase></screen>
  3633. </listitem>
  3634. <listitem>
  3635. <para><literal>Robert Stayton: index.links.to.section.xml</literal></para><screen><phrase role="commit-message">Add param to control whether an <tag>index</tag> <tag>entry</tag> links to
  3636. a <tag>section</tag> <tag>title</tag> or to the precise location of the
  3637. <tag>indexterm</tag>.</phrase></screen>
  3638. </listitem>
  3639. <listitem>
  3640. <para><literal>Robert Stayton: glossentry.list.item.properties.xml</literal></para><screen><phrase role="commit-message">New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</phrase></screen>
  3641. </listitem>
  3642. <listitem>
  3643. <para><literal>Robert Stayton: monospace.verbatim.font.width.xml</literal></para><screen><phrase role="commit-message">New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</phrase></screen>
  3644. </listitem>
  3645. <listitem>
  3646. <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated and reorganized the description.</phrase></screen>
  3647. </listitem>
  3648. <listitem>
  3649. <para><literal>Robert Stayton: page.margin.outer.xml; page.margin.inner.xml</literal></para><screen><phrase role="commit-message">Add caveat about XEP bug when writing-mode is right-to-left.</phrase></screen>
  3650. </listitem>
  3651. <listitem>
  3652. <para><literal>Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml; body.start.indent&#x22EF;</literal></para><screen><phrase role="commit-message">Change 'left' to 'start' and 'right' to 'end' to support right-to-left
  3653. writing mode.</phrase></screen>
  3654. </listitem>
  3655. <listitem>
  3656. <para><literal>Robert Stayton: glossdef.block.properties.xml; glossdef.list.properties.xml; glossterm.blo&#x22EF;</literal></para><screen><phrase role="commit-message">Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</phrase></screen>
  3657. </listitem>
  3658. <listitem>
  3659. <para><literal>Robert Stayton: glossterm.separation.xml</literal></para><screen><phrase role="commit-message">Clarify the description.</phrase></screen>
  3660. </listitem>
  3661. <listitem>
  3662. <para><literal>Robert Stayton: make.year.ranges.xml</literal></para><screen><phrase role="commit-message">Now handles <tag>year</tag> element containing a comma or dash without error.</phrase></screen>
  3663. </listitem>
  3664. </itemizedlist>
  3665. </sect2><!--end of Params changes for 1.75.0-->
  3666. <sect2 xml:id="rn_V1.75.0_Highlighting">
  3667. <title>Highlighting</title>
  3668. <para>The following changes have been made to the
  3669. <filename>highlighting</filename> code
  3670. since the 1.74.3 release.</para>
  3671. <itemizedlist>
  3672. <listitem>
  3673. <para><literal>Jirka Kosek: README</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
  3674. </listitem>
  3675. <listitem>
  3676. <para><literal>Keith Fahlgren: README</literal></para><screen><phrase role="commit-message">Adding XSLTHL readme</phrase></screen>
  3677. </listitem>
  3678. <listitem>
  3679. <para><literal>Keith Fahlgren: common.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
  3680. </listitem>
  3681. </itemizedlist>
  3682. </sect2><!--end of Highlighting changes for 1.75.0-->
  3683. <sect2 xml:id="rn_V1.75.0_XSL-Saxon">
  3684. <title>XSL-Saxon</title>
  3685. <para>The following changes have been made to the
  3686. <filename>xsl-saxon</filename> code
  3687. since the 1.74.3 release.</para>
  3688. <itemizedlist>
  3689. <listitem>
  3690. <para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/Text.java</literal></para><screen><phrase role="commit-message">Added a fix that prevents output of extra blank line.
  3691. Hopefully this closes bug #894805.</phrase></screen>
  3692. </listitem>
  3693. </itemizedlist>
  3694. </sect2><!--end of XSL-Saxon changes for 1.75.0-->
  3695. <sect2 xml:id="rn_V1.75.0_XSL-Xalan">
  3696. <title>XSL-Xalan</title>
  3697. <para>The following changes have been made to the
  3698. <filename>xsl-xalan</filename> code
  3699. since the 1.74.3 release.</para>
  3700. <itemizedlist>
  3701. <listitem>
  3702. <para><literal>Mauritz Jeanson: src/com/nwalsh/xalan/Text.java</literal></para><screen><phrase role="commit-message">Added a fix that prevents output of extra blank line.
  3703. Hopefully this closes bug #894805.</phrase></screen>
  3704. </listitem>
  3705. </itemizedlist>
  3706. </sect2><!--end of XSL-Xalan changes for 1.75.0-->
  3707. </sect1>
  3708. <sect1 xml:id="V1.74.3">
  3709. <title>Release Notes: 1.74.3</title>
  3710. <para>This release fixes some bugs in the 1.74.2 release.</para>
  3711. <para>See <filename>highlighting/README</filename> for XSLTHL usage instructions.</para>
  3712. </sect1>
  3713. <sect1 xml:id="V1.74.2">
  3714. <title>Release Notes: 1.74.2</title>
  3715. <para>This release fixes some bugs in the 1.74.1 release.</para>
  3716. </sect1>
  3717. <sect1 xml:id="V1.74.1">
  3718. <title>Release Notes: 1.74.1</title>
  3719. <para>This release includes important bug fixes and adds the following
  3720. significant feature changes:
  3721. <variablelist>
  3722. <varlistentry>
  3723. <term>Gentext</term>
  3724. <listitem><para>Kirghiz locale added and Chinese translations have been simplified.</para></listitem>
  3725. <listitem><para>Somme support for gentext and right-to-left languages has been added.</para></listitem>
  3726. </varlistentry>
  3727. <varlistentry>
  3728. <term>FO</term>
  3729. <listitem><para>Various bugs have been resolved. </para> </listitem>
  3730. <listitem><para>Support for a new processing instruction: <markup>dbfo funcsynopsis-style</markup> has been added. </para> </listitem>
  3731. <listitem><para>Added new param <parameter>email.mailto.enabled</parameter> for FO output. Patch from Paolo Borelli. </para>
  3732. </listitem>
  3733. <listitem><para>Support for documented metadata in fop1 mode has been added. </para>
  3734. </listitem>
  3735. </varlistentry>
  3736. <varlistentry>
  3737. <term>Highlighting</term>
  3738. <listitem><para>Support for the latest version of XSLTHL 2.0 and some new language syntaxes have been added to a variety of outputs.</para></listitem>
  3739. </varlistentry>
  3740. <varlistentry>
  3741. <term>Manpages</term>
  3742. <listitem><para>Added man.output.better.ps.enabled param (zero default). It non-zero, no such
  3743. markup is embedded in generated man pages, and no enhancements are
  3744. included in the PostScript output generated from those man pages
  3745. by the man -Tps <tag>command</tag>.</para></listitem>
  3746. </varlistentry>
  3747. <varlistentry>
  3748. <term>HTML</term>
  3749. <listitem><para>Support for <parameter>writing.mode</parameter> to set text direction and <parameter>alignment</parameter> based on document locale has been added.</para></listitem>
  3750. <listitem>
  3751. <para>Added a new top-level stylesheet module, chunk-changebars.xsl, to be
  3752. used for generating chunked output with highlighting based on change
  3753. (@revisionflag) markup. The module imports/includes the standard chunking
  3754. and changebars templates and contains additional logic for chunked output.
  3755. See FRs #1015180 and #1819915.</para>
  3756. </listitem>
  3757. </varlistentry>
  3758. <varlistentry>
  3759. <term>ePub</term>
  3760. <listitem>
  3761. <para>Covers now look better in Adobe Digital Editions thanks to a patch from Paul Norton of Adobe</para>
  3762. </listitem>
  3763. <listitem><para>Cover handling now more generic (including limited DocBook 5.0 <markup>cover</markup> support thanks to patch contributed by Liza Daly.</para> </listitem>
  3764. <listitem><para>Cover markup now carries more reliably into files destined for .mobi and the Kindle.</para> </listitem>
  3765. <listitem><para><markup>dc:identifiers</markup> are now generated from more types of numbering schemes. </para></listitem>
  3766. <listitem><para>Both SEO and semantic structure of chunked ePub output by ensuring that we always send out one and only one h1 in each XHTML chunk.</para></listitem>
  3767. <listitem>
  3768. <para>Primitive support for embedding a single font added.</para>
  3769. </listitem>
  3770. <listitem>
  3771. <para>Support for embedding a CSS customizations added.</para>
  3772. </listitem>
  3773. </varlistentry>
  3774. <varlistentry>
  3775. <term>Roundtrip</term>
  3776. <listitem>
  3777. <para>Support for imagedata-metadata and <tag>table</tag> as images added.</para>
  3778. </listitem>
  3779. <listitem>
  3780. <para>Support for imagedata-metadata and <tag>legalnotice</tag> as images added.</para>
  3781. </listitem>
  3782. </varlistentry>
  3783. <varlistentry>
  3784. <term>Params</term>
  3785. <listitem><para><parameter>man.output.better.ps.enabled</parameter> added for Manpages output </para></listitem>
  3786. <listitem>
  3787. <para><parameter>writing.mode.xml</parameter> added to set text direction.</para>
  3788. </listitem>
  3789. <listitem>
  3790. <para>Added new param <parameter>email.mailto.enabled</parameter> for FO output.
  3791. Patch from Paolo Borelli. Closes #2086321.</para>
  3792. </listitem>
  3793. <listitem>
  3794. <para><parameter>highlight.source</parameter> upgraded to support the latest version of XSLTHL 2.0.</para>
  3795. </listitem>
  3796. </varlistentry>
  3797. </variablelist>
  3798. </para>
  3799. <para>The following is a list of changes that have been made since the 1.74.0 release.</para>
  3800. <sect2 xml:id="summary_V1.74.1_Gentext">
  3801. <title>Gentext</title>
  3802. <para>The following changes have been made to the <filename>gentext</filename> code since the 1.74.0 release.</para>
  3803. <itemizedlist>
  3804. <listitem>
  3805. <para><literal>Michael(tm) Smith: locale/ky.xml; Makefile</literal></para><screen><phrase role="commit-message">new Kirghiz locale from Ilyas Bakirov</phrase></screen>
  3806. </listitem>
  3807. <listitem>
  3808. <para><literal>Mauritz Jeanson: locale/en.xml</literal></para><screen><phrase role="commit-message">Added "<tag>Acknowledgements</tag>".</phrase></screen>
  3809. </listitem>
  3810. <listitem>
  3811. <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Simplified Chinese translation.</phrase></screen>
  3812. </listitem>
  3813. <listitem>
  3814. <para><literal>Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml; locale/af.xml;&#x22EF;</literal></para><screen><phrase role="commit-message">Add writing-mode gentext string to support right-to-left languages.</phrase></screen>
  3815. </listitem>
  3816. </itemizedlist>
  3817. </sect2><!--end of Gentext changes for 1.74.1-->
  3818. <sect2 xml:id="summary_V1.74.1_FO">
  3819. <title>FO</title>
  3820. <para>The following changes have been made to the <filename>fo</filename> code since the 1.74.0 release.</para>
  3821. <itemizedlist>
  3822. <listitem>
  3823. <para><literal>David Cramer: footnote.xsl</literal></para><screen><phrase role="commit-message">Added a check to confirm that a <tag>footnoteref</tag>'s linkend points to a <tag>footnote</tag>. Stylesheets stop processing if not and provide a useful error message.</phrase></screen>
  3824. </listitem>
  3825. <listitem>
  3826. <para><literal>Mauritz Jeanson: spaces.xsl</literal></para><screen><phrase role="commit-message">Convert spaces to fo:leader also in elements in the DB 5 namespace.</phrase></screen>
  3827. </listitem>
  3828. <listitem>
  3829. <para><literal>Mauritz Jeanson: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Added support for a new processing instruction: dbfo funcsynopsis-style.
  3830. Closes bug #1838213.</phrase></screen>
  3831. </listitem>
  3832. <listitem>
  3833. <para><literal>Michael(tm) Smith: inline.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param <parameter>email.mailto.enabled</parameter> for FO output.
  3834. Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
  3835. </listitem>
  3836. <listitem>
  3837. <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added support for document metadata for fop1 (patch #2067318).</phrase></screen>
  3838. </listitem>
  3839. <listitem>
  3840. <para><literal>Jirka Kosek: param.ent; param.xweb; highlight.xsl</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
  3841. -- nested markup in highlited code is now processed
  3842. -- it is no longer needed to specify path XSLTHL configuration file using Java property
  3843. -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
  3844. </listitem>
  3845. </itemizedlist>
  3846. </sect2><!--end of FO changes for 1.74.1-->
  3847. <sect2 xml:id="summary_V1.74.1_HTML">
  3848. <title>HTML</title>
  3849. <para>The following changes have been made to the <filename>html</filename> code since the 1.74.0 release.</para>
  3850. <itemizedlist>
  3851. <listitem>
  3852. <para><literal>Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>writing.mode</parameter> to set text direction and <parameter>alignment</parameter> based on document locale.</phrase></screen>
  3853. </listitem>
  3854. <listitem>
  3855. <para><literal>Mauritz Jeanson: chunk-changebars.xsl</literal></para><screen><phrase role="commit-message">Added a new top-level stylesheet module, chunk-changebars.xsl, to be
  3856. used for generating chunked output with highlighting based on change
  3857. (@revisionflag) markup. The module imports/includes the standard chunking
  3858. and changebars templates and contains additional logic for chunked output.
  3859. See FRs #1015180 and #1819915.</phrase></screen>
  3860. </listitem>
  3861. </itemizedlist>
  3862. </sect2><!--end of HTML changes for 1.74.1-->
  3863. <sect2 xml:id="summary_V1.74.1_Manpages">
  3864. <title>Manpages</title>
  3865. <para>The following changes have been made to the <filename>manpages</filename> code since the 1.74.0 release.</para>
  3866. <itemizedlist>
  3867. <listitem>
  3868. <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Put the following at the top of generated roff for each page:
  3869. \" t
  3870. purpose is to explicitly tell AT&amp;T troff that the page needs to be
  3871. pre-processed through tbl(1); groff can <tag>figure</tag> it out
  3872. automatically, but apparently AT&amp;T troff needs to be explicitly told</phrase></screen>
  3873. </listitem>
  3874. </itemizedlist>
  3875. </sect2><!--end of Manpages changes for 1.74.1-->
  3876. <sect2 xml:id="summary_V1.74.1_Epub">
  3877. <title>ePub</title>
  3878. <para>The following changes have been made to the <filename>epub</filename> code since the 1.74.0 release.</para>
  3879. <itemizedlist>
  3880. <listitem>
  3881. <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions</phrase></screen>
  3882. </listitem>
  3883. <listitem>
  3884. <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/v5cover.xml; bin/spec/sp&#x22EF;</literal></para><screen><phrase role="commit-message">Patch contributed by Liza Daly to make ePub <tag>cover</tag> handling more generic. Additionally
  3885. DocBook 5.0's &lt;<tag>cover</tag>&gt; now has some limited support:
  3886. - should <tag>reference</tag> a <tag>cover</tag> in the OPF guide for a DocBook 5.0 test document</phrase></screen>
  3887. </listitem>
  3888. <listitem>
  3889. <para><literal>Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/files/biblioid.&#x22EF;</literal></para><screen><phrase role="commit-message">Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
  3890. Added new tests:
  3891. - should include at least one dc:identifier
  3892. - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
  3893. - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
  3894. - should include an <tag>biblioid</tag> as a dc:identifier if an <tag>biblioid</tag> was in the metadata
  3895. - should include a URN for a <tag>biblioid</tag> with @class attribute as a dc:identifier if an <tag>biblioid</tag> was in the metadata</phrase></screen>
  3896. </listitem>
  3897. <listitem>
  3898. <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb</literal></para><screen><phrase role="commit-message">Improve both SEO and semantic structure of chunked ePub output by ensuring that
  3899. we always send out one and only one h1 in each XHTML chunk.
  3900. DocBook::Epub
  3901. - should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
  3902. for &lt;<tag>book</tag>&gt;s
  3903. - should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
  3904. for &lt;<tag>book</tag>&gt;s even if they do not have <tag>section</tag> markup</phrase></screen>
  3905. </listitem>
  3906. <listitem>
  3907. <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x&#x22EF;</literal></para><screen><phrase role="commit-message">Adding better support for covers in epub files destined for .mobi and the Kindle</phrase></screen>
  3908. </listitem>
  3909. <listitem>
  3910. <para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/DejaVuSerif.otf; docbook.&#x22EF;</literal></para><screen><phrase role="commit-message">Adding primitive support for embedding a single font</phrase></screen>
  3911. </listitem>
  3912. <listitem>
  3913. <para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/test_cust.xsl; bin/spec/e&#x22EF;</literal></para><screen><phrase role="commit-message">Adding support for user-specified customization layers in dbtoepub</phrase></screen>
  3914. </listitem>
  3915. <listitem>
  3916. <para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s&#x22EF;</literal></para><screen><phrase role="commit-message">Adding CSS support to .epub target &amp; dbtoepub:
  3917. -c, --css [FILE] Use FILE for CSS on generated XHTML.
  3918. DocBook::Epub
  3919. ...
  3920. - should include a CSS <tag>link</tag> in HTML files when a CSS file has been provided
  3921. - should include CSS file in .epub when a CSS file has been provided
  3922. - should include a CSS <tag>link</tag> in OPF file when a CSS file has been provided</phrase></screen>
  3923. </listitem>
  3924. </itemizedlist>
  3925. </sect2><!--end of Epub changes for 1.74.1-->
  3926. <sect2 xml:id="summary_V1.74.1_Roundtrip">
  3927. <title>Roundtrip</title>
  3928. <para>The following changes have been made to the
  3929. <filename>roundtrip</filename> code
  3930. since the 1.74.0 release.</para>
  3931. <itemizedlist>
  3932. <listitem>
  3933. <para><literal>Steve Ball: blocks2dbk.xsl; template.xml; template.dot</literal></para><screen><phrase role="commit-message">added support for imagedata-metadata
  3934. added support for <tag>table</tag> as images</phrase></screen>
  3935. </listitem>
  3936. <listitem>
  3937. <para><literal>Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl</literal></para><screen><phrase role="commit-message">Improved support for <tag>personname</tag> inlines.</phrase></screen>
  3938. </listitem>
  3939. <listitem>
  3940. <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</literal></para><screen><phrase role="commit-message">Added support for <tag>legalnotice</tag>.</phrase></screen>
  3941. </listitem>
  3942. <listitem>
  3943. <para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for <tag>orgname</tag> in <tag>author</tag></phrase></screen>
  3944. </listitem>
  3945. <listitem>
  3946. <para><literal>Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl; wordml2normalise.xsl; dbk2w&#x22EF;</literal></para><screen><phrase role="commit-message">Updated specification.
  3947. to-DocBook: add cols attribute to <tag>tgroup</tag>
  3948. from-DocBook: fix for <tag>blockquote</tag> <tag>title</tag></phrase></screen>
  3949. </listitem>
  3950. </itemizedlist>
  3951. </sect2><!--end of Roundtrip changes for 1.74.1-->
  3952. <sect2 xml:id="summary_V1.74.1_Params">
  3953. <title>Params</title>
  3954. <para>The following changes have been made to the <filename>params</filename> since the 1.74.0 release.</para>
  3955. <itemizedlist>
  3956. <listitem>
  3957. <para>The change was to add man.output.better.ps.enabled parameter, with
  3958. its default value set to zero.
  3959. If the value of the man.output.better.ps.enabled parameter is
  3960. non-zero, certain markup is embedded in each generated man page
  3961. such that PostScript output from the man -Tps <tag>command</tag> for that
  3962. page will include a number of enhancements designed to improve the
  3963. quality of that output.
  3964. If man.output.better.ps.enabled is zero (the default), no such
  3965. markup is embedded in generated man pages, and no enhancements are
  3966. included in the PostScript output generated from those man pages
  3967. by the man -Tps <tag>command</tag>.
  3968. WARNING: The enhancements provided by this parameter rely on
  3969. features that are specific to groff (GNU troff) and that are not
  3970. part of "classic" AT&amp;T troff or any of its derivatives. Therefore,
  3971. any man pages you generate with this parameter enabled will be
  3972. readable only on systems on which the groff (GNU troff) program is
  3973. installed, such as GNU/Linux systems. The pages will not not be
  3974. readable on systems on with the classic troff (AT&amp;T troff) <tag>command</tag>
  3975. is installed.
  3976. NOTE: The value of this parameter only affects PostScript output
  3977. generated from the man <tag>command</tag>. It has no effect on output
  3978. generated using the FO backend.
  3979. <tag>TIP</tag>: You can generate PostScript output for any man page by
  3980. running the following <tag>command</tag>:
  3981. man FOO -Tps &gt; FOO.ps
  3982. You can then generate PDF output by running the following <tag>command</tag>:
  3983. ps2pdf FOO.ps</para>
  3984. </listitem>
  3985. <listitem>
  3986. <para><literal>Robert Stayton: writing.mode.xml</literal></para><screen><phrase role="commit-message">writing mode param used to set text direction.</phrase></screen>
  3987. </listitem>
  3988. <listitem>
  3989. <para><literal>Michael(tm) Smith: email.mailto.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>email.mailto.enabled</parameter> for FO output.
  3990. Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
  3991. </listitem>
  3992. <listitem>
  3993. <para><literal>Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
  3994. -- nested markup in highlited code is now processed
  3995. -- it is no longer needed to specify path XSLTHL configuration file using Java property
  3996. -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
  3997. </listitem>
  3998. </itemizedlist>
  3999. </sect2><!--end of Params changes for 1.74.1-->
  4000. <sect2 xml:id="summary_V1.74.1_Highlighting">
  4001. <title>Highlighting</title>
  4002. <para>The following changes have been made to the
  4003. <filename>highlighting</filename> code
  4004. since the 1.74.0 release.</para>
  4005. <itemizedlist>
  4006. <listitem>
  4007. <para><literal>Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl; perl-hl.xml; delphi&#x22EF;</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
  4008. -- nested markup in highlited code is now processed
  4009. -- it is no longer needed to specify path XSLTHL configuration file using Java property
  4010. -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
  4011. </listitem>
  4012. </itemizedlist>
  4013. </sect2><!--end of Highlighting changes for 1.74.1-->
  4014. </sect1>
  4015. <sect1 xml:id="V1.74.0">
  4016. <title>Release Notes: 1.74.0</title>
  4017. <para>This release includes important bug fixes and adds the following
  4018. significant feature changes:
  4019. <variablelist>
  4020. <varlistentry>
  4021. <term>.epub target</term>
  4022. <listitem><para>Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code that generates <filename>.epub</filename> documents from
  4023. DocBook input. An alpha-reference implementation in Ruby has also been provided.</para>
  4024. <para>.epub is an open standard of the The International Digital Publishing Forum (IDPF),
  4025. a the trade and standards association for the digital publishing industry. </para>
  4026. <para>Read more about this target in <filename>epub/README</filename>
  4027. </para></listitem>
  4028. </varlistentry>
  4029. <varlistentry>
  4030. <term>XHTML 1.1 target</term>
  4031. <listitem><para>To support .epub output, a strict XHTML 1.1 target has been added. The stylesheets for this output are
  4032. generated and are quite similar to the XHTML target.</para></listitem>
  4033. </varlistentry>
  4034. <varlistentry>
  4035. <term>Gentext updates</term>
  4036. <listitem><para>A number of locales have been updated.</para></listitem>
  4037. </varlistentry>
  4038. <varlistentry>
  4039. <term>Roundtrip improvements</term>
  4040. <listitem><para>Table, figure, template syncronization, and character style improvements have been made for WordML &amp; Pages. Support added for OpenOffice.org.</para></listitem>
  4041. </varlistentry>
  4042. <varlistentry>
  4043. <term>First implementation of a libxslt extension</term>
  4044. <listitem>
  4045. <para>A stylesheet extension for libxslt, written in Python, has been added.
  4046. The extension is a function for adjusting column widths in CALS tables. See
  4047. <filename>extensions/README.LIBXSLT</filename> for more information.</para>
  4048. </listitem>
  4049. </varlistentry>
  4050. </variablelist>
  4051. </para>
  4052. <para>The following is a list of changes that have been made
  4053. since the 1.73.2 release.</para>
  4054. <sect2 xml:id="V1.74.0_Gentext">
  4055. <title>Gentext</title>
  4056. <para>The following changes have been made to the
  4057. <filename>gentext</filename> code
  4058. since the 1.73.2 release.</para>
  4059. <itemizedlist>
  4060. <listitem>
  4061. <para><literal>Michael(tm) Smith: locale/id.xml</literal></para><screen><phrase role="commit-message">Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.</phrase></screen>
  4062. </listitem>
  4063. <listitem>
  4064. <para><literal>Michael(tm) Smith: locale/lt.xml</literal></para><screen><phrase role="commit-message">Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.</phrase></screen>
  4065. </listitem>
  4066. <listitem>
  4067. <para><literal>Michael(tm) Smith: locale/hu.xml</literal></para><screen><phrase role="commit-message">fixed error in lowercase.alpha definition in Hungarian locale</phrase></screen>
  4068. </listitem>
  4069. <listitem>
  4070. <para><literal>Michael(tm) Smith: locale/nb.xml</literal></para><screen><phrase role="commit-message">Corrected language code for nb locale, and restored missing "startquote" key.</phrase></screen>
  4071. </listitem>
  4072. <listitem>
  4073. <para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
  4074. before.</phrase></screen>
  4075. </listitem>
  4076. <listitem>
  4077. <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
  4078. </listitem>
  4079. <listitem>
  4080. <para><literal>Michael(tm) Smith: locale/nb.xml</literal></para><screen><phrase role="commit-message">Update Norwegian Bokm&#xE5;l translation. Thanks to Hans F. Nordhaug.</phrase></screen>
  4081. </listitem>
  4082. <listitem>
  4083. <para><literal>Michael(tm) Smith: locale/no.xml; locale/nb.xml</literal></para><screen><phrase role="commit-message">per message from Hans F. Nordhaug, correct identifier for
  4084. Norwegian Bokm&#xE5;l is "nb" (not "no") and has been for quite some
  4085. time now...</phrase></screen>
  4086. </listitem>
  4087. <listitem>
  4088. <para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Converted ja.xml source file to use real unicode characters so
  4089. that the actual glyphs so up when you edit it in a text editor
  4090. (instead of the character references).</phrase></screen>
  4091. </listitem>
  4092. <listitem>
  4093. <para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.</phrase></screen>
  4094. </listitem>
  4095. <listitem>
  4096. <para><literal>Michael(tm) Smith: locale/it.xml</literal></para><screen><phrase role="commit-message">Changes from Federico Zenith</phrase></screen>
  4097. </listitem>
  4098. <listitem>
  4099. <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Added missing translations.</phrase></screen>
  4100. </listitem>
  4101. </itemizedlist>
  4102. </sect2><!--end of Gentext changes for 1.74.0-->
  4103. <sect2 xml:id="V1.74.0_Common">
  4104. <title>Common</title>
  4105. <para>The following changes have been made to the
  4106. <filename>common</filename> code
  4107. since the 1.73.2 release.</para>
  4108. <itemizedlist>
  4109. <listitem>
  4110. <para><literal>Michael(tm) Smith: l10n.xsl</literal></para><screen><phrase role="commit-message">Added new template "l10.language.name" for retrieving the
  4111. English-language name of the lang setting of the current document.
  4112. Closes #1916837. Thanks to Simon Kennedy.</phrase></screen>
  4113. </listitem>
  4114. <listitem>
  4115. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed syntax error</phrase></screen>
  4116. </listitem>
  4117. <listitem>
  4118. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed a couple of typos</phrase></screen>
  4119. </listitem>
  4120. <listitem>
  4121. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined handling of cases where refentry "source" or "manual"
  4122. metadata is missing or when we use fallback content instead. We
  4123. now report a Warning if we use fallback content.</phrase></screen>
  4124. </listitem>
  4125. <listitem>
  4126. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">don't use refmiscinfo@class=date value as fallback for refentry
  4127. "source" or "manual" metadata fields</phrase></screen>
  4128. </listitem>
  4129. <listitem>
  4130. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Made reporting of missing refentry metadata more quiet:
  4131. - we no longer report anything if usable-but-not-preferred
  4132. metadata is found; we just quietly use whatever we manage to
  4133. find
  4134. - we now only report missing "source" metadata if the refentry
  4135. is missing BOTH "source name" and "version" metadata; if it
  4136. has one but not the other, we use whichever one it has and
  4137. don't report anything as missing
  4138. The above changes were made because testing with some "real world"
  4139. source reveals that some authors are intentionally choosing to use
  4140. "non preferred" markup for some metadata, and also choosing to
  4141. omit "source name" or "version" metadata in there DocBook XML. So
  4142. it does no good to give them pedantic reminders about what they
  4143. already know...
  4144. Also, changed code to cause "fixme" text to be inserted in output
  4145. in particular cases:
  4146. - if we can't manage to find any "source" metadata at all, we
  4147. now put fixme text into the output
  4148. - if we can't manage to find any "manual" metadata a all, we
  4149. now put fixme text into the output
  4150. The "source" and "manual" metadata is necessary information, so
  4151. buy putting the fixme stuff in the output, we alert users to the
  4152. need problem of it being missing.</phrase></screen>
  4153. </listitem>
  4154. <listitem>
  4155. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">When generating manpages output, we no longer report anything if
  4156. the refentry source is missing date or pubdate content. In
  4157. practice, many users intentionally omit the date from the source
  4158. because they explicitly want it to be generated.</phrase></screen>
  4159. </listitem>
  4160. <listitem>
  4161. <para><literal>Michael(tm) Smith: l10n.xml</literal></para><screen><phrase role="commit-message">further change needed for switch from no locale to nb.</phrase></screen>
  4162. </listitem>
  4163. <listitem>
  4164. <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support for orgname in authorgroup. Thanks to Camille
  4165. B&#xE9;gnis.</phrase></screen>
  4166. </listitem>
  4167. <listitem>
  4168. <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
  4169. </listitem>
  4170. <listitem>
  4171. <para><literal>Mauritz Jeanson: stripns.xsl</literal></para><screen><phrase role="commit-message">Removed the template matching "ng:link|db:link" (in order to make @xlink:show
  4172. work with &lt;link&gt; elements). As far as I can tell, this template is no longer needed.</phrase></screen>
  4173. </listitem>
  4174. <listitem>
  4175. <para><literal>Mauritz Jeanson: entities.ent</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
  4176. </listitem>
  4177. <listitem>
  4178. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
  4179. Having xref in title is not a problem as long as the target is not an ancestor element.
  4180. Closes bug #1838136.
  4181. Note that an xref that is in a title and whose target is an ancestor element is still not
  4182. rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
  4183. see the point in having such an xref in a document.</phrase></screen>
  4184. </listitem>
  4185. <listitem>
  4186. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added a "not(ancestor::title)" test to work around "too many nested
  4187. apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
  4188. Hopefully, this closes bug #1811721.</phrase></screen>
  4189. </listitem>
  4190. <listitem>
  4191. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Removed old template matching "link" in no.anchor.mode mode.</phrase></screen>
  4192. </listitem>
  4193. <listitem>
  4194. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Process &lt;link&gt; in no.anchor.mode mode with the same template as &lt;xref&gt;.
  4195. Closes bug #1759205 (Empty link in no.anchor.mode mode).</phrase></screen>
  4196. </listitem>
  4197. <listitem>
  4198. <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">In no.anchor.mode mode, do not output anchors for elements that are descendants
  4199. of &lt;title&gt;. Previously, having inline elements with @id/@xml:id in &lt;title&gt;s
  4200. resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.</phrase></screen>
  4201. </listitem>
  4202. </itemizedlist>
  4203. </sect2><!--end of Common changes for 1.74.0-->
  4204. <sect2 xml:id="V1.74.0_FO">
  4205. <title>FO</title>
  4206. <para>The following changes have been made to the
  4207. <filename>fo</filename> code
  4208. since the 1.73.2 release.</para>
  4209. <itemizedlist>
  4210. <listitem> <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for keep-together.</phrase></screen> </listitem>
  4211. <listitem> <para><literal>Mauritz Jeanson: task.xsl</literal></para><screen><phrase role="commit-message">Enabled use of the keep-together PI on <tag>task</tag> elements.</phrase></screen> </listitem>
  4212. <listitem>
  4213. <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">FOP1 requires fo:wrapper for inline index entries, not fo:inline.</phrase></screen>
  4214. </listitem>
  4215. <listitem>
  4216. <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fixed non-working inline.or.block template for indexterm wrappers.
  4217. Add fop1 to list of processors using inline.or.block.</phrase></screen>
  4218. </listitem>
  4219. <listitem>
  4220. <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1891965 (colsep in entytbl not working).</phrase></screen>
  4221. </listitem>
  4222. <listitem>
  4223. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support for title in revhistory. Closes bug #1842847.</phrase></screen>
  4224. </listitem>
  4225. <listitem>
  4226. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Small doc cleanup (dbfo float-type).</phrase></screen>
  4227. </listitem>
  4228. <listitem>
  4229. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Insert commas between multiple copyright holders.</phrase></screen>
  4230. </listitem>
  4231. <listitem>
  4232. <para><literal>Mauritz Jeanson: autotoc.xsl; division.xsl</literal></para><screen><phrase role="commit-message">Added modifications to support nested set elements. See bug #1853172.</phrase></screen>
  4233. </listitem>
  4234. <listitem>
  4235. <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.</phrase></screen>
  4236. </listitem>
  4237. <listitem>
  4238. <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry</phrase></screen>
  4239. </listitem>
  4240. <listitem>
  4241. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
  4242. and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
  4243. </listitem>
  4244. <listitem>
  4245. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
  4246. </listitem>
  4247. <listitem>
  4248. <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Updated message about unmatched element.</phrase></screen>
  4249. </listitem>
  4250. <listitem>
  4251. <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
  4252. </listitem>
  4253. <listitem>
  4254. <para><literal>Mauritz Jeanson: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed typo (refsynopsysdiv -&gt; refsynopsisdiv).</phrase></screen>
  4255. </listitem>
  4256. <listitem>
  4257. <para><literal>David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl</literal></para><screen><phrase role="commit-message">Added test to check generate.index param when generating pdf bookmarks</phrase></screen>
  4258. </listitem>
  4259. <listitem>
  4260. <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for MathML in imagedata.</phrase></screen>
  4261. </listitem>
  4262. <listitem>
  4263. <para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Removed unnecessary extra test condition in test express that
  4264. checks for passivetex.</phrase></screen>
  4265. </listitem>
  4266. <listitem>
  4267. <para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Don't use fo:instream-foreign-object if we are processing with
  4268. passivetex. Closes #1806899. Thanks to Justus Piater.</phrase></screen>
  4269. </listitem>
  4270. <listitem>
  4271. <para><literal>Mauritz Jeanson: component.xsl</literal></para><screen><phrase role="commit-message">Added code to output a TOC for an appendix in an article when
  4272. generate.toc='article/appendix toc'. Closes bug #1669658.</phrase></screen>
  4273. </listitem>
  4274. <listitem>
  4275. <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
  4276. </listitem>
  4277. <listitem>
  4278. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for dbfo_label-width.</phrase></screen>
  4279. </listitem>
  4280. <listitem>
  4281. <para><literal>Mauritz Jeanson: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for the dbfo_label-width PI in calloutlists.</phrase></screen>
  4282. </listitem>
  4283. <listitem>
  4284. <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Support finding glossary database entries inside bibliodivs.</phrase></screen>
  4285. </listitem>
  4286. <listitem>
  4287. <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Complete support for &lt;?dbfo pgwide="1"?&gt; for informal
  4288. elements too.</phrase></screen>
  4289. </listitem>
  4290. <listitem>
  4291. <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">In the table.block template, added a check for the dbfo_keep-together PI, so that
  4292. a table may break (depending on the PI value) at a page break. This was needed
  4293. since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
  4294. by default, which prevents the table from breaking. Closes bug #1740964 (Titled
  4295. table does not respect dbfo PI).</phrase></screen>
  4296. </listitem>
  4297. <listitem>
  4298. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added a few missing @role="tcg".</phrase></screen>
  4299. </listitem>
  4300. <listitem>
  4301. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Use normalize-space() in glossterm comparisons (as in html/inline.xsl).</phrase></screen>
  4302. </listitem>
  4303. <listitem>
  4304. <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
  4305. This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
  4306. with index.on.type=1. Closes bug #1680836.</phrase></screen>
  4307. </listitem>
  4308. <listitem>
  4309. <para><literal>Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Added capability in FO output for displaying URLs for all
  4310. hyperlinks (elements marked up with xlink:href attributes) in the
  4311. same way as URLs for ulinks are already handled (which is to say,
  4312. either inline or as numbered footnotes).
  4313. Background on this change:
  4314. DocBook 5 allows "ubiquitous" linking, which means you can make
  4315. any element a hyperlink just by adding an xlink:href attribute to
  4316. it, with the value set to an external URL. That's in contrast to
  4317. DocBook 4, which only allows you to use specific elements (e.g.,
  4318. the link and ulink elements) to mark up hyperlinks.
  4319. The existing FO stylesheets have a mechanism for handling display
  4320. of URLs for hyperlinks that are marked up with ulink, but they did
  4321. not handle display of URLs for elements that were marked up with
  4322. xlink:href attributes. This change adds handling for those other
  4323. elements, enabling the URLs they link to be displayed either
  4324. inline or as numbered footnotes (depending on what values the user
  4325. has the ulink.show and ulink.footnotes params set to).
  4326. Note that this change only adds URL display support for elements
  4327. that call the simple.xlink template -- which currently is most
  4328. (but not all) inline elements.
  4329. This change also moves the URL display handling out of the ulink
  4330. template and into a new "hyperlink.url.display" named template;
  4331. the ulink template and the simple.xlink named template now both
  4332. call the hyperlink.url.display template.
  4333. Warning: In the stylesheet code that determines what footnote
  4334. number to assign to each footnote or external hyperlink, there is
  4335. an XPath expression for determining whether a particular
  4336. xlink:href instance is an external hyperlink; that expression is
  4337. necessarily a bit complicated and further testing may reveal that
  4338. it doesn't handle all cases as expected -- so some refinements to
  4339. it may need to be done later.
  4340. Closes #1785519. Thanks to Ken Morse for reporting and
  4341. troubleshooting the problem.</phrase></screen>
  4342. </listitem>
  4343. </itemizedlist>
  4344. </sect2><!--end of FO changes for 1.74.0-->
  4345. <sect2 xml:id="V1.74.0_HTML">
  4346. <title>HTML</title>
  4347. <para>The following changes have been made to the
  4348. <filename>html</filename> code
  4349. since the 1.73.2 release.</para>
  4350. <itemizedlist>
  4351. <listitem> <para><literal>Keith Fahlgren: inline.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Work to make HTML and XHTML targets more valid</phrase></screen> </listitem>
  4352. <listitem> <para><literal>Keith Fahlgren: table.xsl</literal></para><screen><phrase role="commit-message">Add better handling for tables that have footnotes in the titles</phrase></screen> </listitem>
  4353. <listitem> <para><literal>Keith Fahlgren: biblio.xsl</literal></para><screen><phrase role="commit-message">Add anchors to bibliodivs</phrase></screen> </listitem>
  4354. <listitem>
  4355. <para><literal>Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
  4356. and Keith Fahlgren of O'Reilly.</phrase></screen>
  4357. <para>This change includes new code for generating the XHTML 1.1 target sanely.</para>
  4358. </listitem>
  4359. <listitem>
  4360. <para><literal>Mauritz Jeanson: biblio.xsl</literal></para><screen><phrase role="commit-message">Added code for creating URLs from biblioids with @class="doi" (representing Digital
  4361. Object Identifiers). See FR #1934434 and http://doi.org.
  4362. To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
  4363. for bibliorelation, bibliosource and citebiblioid.</phrase></screen>
  4364. </listitem>
  4365. <listitem>
  4366. <para><literal>Norman Walsh: formal.xsl</literal></para><screen><phrase role="commit-message">Don't use xsl:copy because it forces the resulting element to be in the same namespace as the source element; in the XHTML stylesheets, that's wrong. But the HTML-to-XHTML converter does the right thing with literal result elements, so use one of them.</phrase></screen>
  4367. </listitem>
  4368. <listitem>
  4369. <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
  4370. under Cygwin. This stuff is ugly and maybe not worth the mess and
  4371. trouble, but does seem to work as expected and not break anything
  4372. else.</phrase></screen>
  4373. </listitem>
  4374. <listitem>
  4375. <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added "exslt" namespace binding to html/docbook.xsl file (in
  4376. addition to existing "exsl" binding. reason is because lack of it
  4377. seems to cause processing problems when using the profiled
  4378. version of the stylsheet</phrase></screen>
  4379. </listitem>
  4380. <listitem>
  4381. <para><literal>Norman Walsh: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Rename link</phrase></screen>
  4382. </listitem>
  4383. <listitem>
  4384. <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Added a fix to make rowsep apply to the last row of thead in entrytbl.</phrase></screen>
  4385. </listitem>
  4386. <listitem>
  4387. <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Simplified and streamlined handling of output for ANSI-style
  4388. funcprototype output, to correct a problem that was causing type
  4389. data to be lost in the output parameter definitions. For example,
  4390. for an instance like this:
  4391. &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
  4392. ... the brackets (indicating an array type) were being dropped.</phrase></screen>
  4393. </listitem>
  4394. <listitem>
  4395. <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Changed HTML handling of K&amp;R-style paramdef output. The parameter
  4396. definitions are no longer output in a table (though the prototype
  4397. still is). The reason for the change is that the
  4398. kr-tabular-funcsynopsis-mode template was causing type data to be
  4399. lost in the output parameter definitions. For example, for an
  4400. instance like this:
  4401. &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
  4402. ... the brackets (indicating an array type) were being dropped.
  4403. The easiest way to deal with the problem is to not try to chop up
  4404. the parameter definitions and display them in table format, but to
  4405. instead just output them as-is. May not look quite as pretty, but
  4406. at least we can be sure no information is being lost...</phrase></screen>
  4407. </listitem>
  4408. <listitem>
  4409. <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">updated wording of doc for funcsynopsis-style PI</phrase></screen>
  4410. </listitem>
  4411. <listitem>
  4412. <para><literal>Michael(tm) Smith: param.xweb; param.ent; synop.xsl</literal></para><screen><phrase role="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
  4413. being used in the code and hasn't been since mid 2006.</phrase></screen>
  4414. </listitem>
  4415. <listitem>
  4416. <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.</phrase></screen>
  4417. </listitem>
  4418. <listitem>
  4419. <para><literal>Mauritz Jeanson: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Added missing space.</phrase></screen>
  4420. </listitem>
  4421. <listitem>
  4422. <para><literal>Norman Walsh: component.xsl</literal></para><screen><phrase role="commit-message">Fix bug where component titles inside info elements were not handled properly</phrase></screen>
  4423. </listitem>
  4424. <listitem>
  4425. <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">Moved dbhtml_stop-chunking embedded doc into alphabetical order,
  4426. fixed text of TCG section it see-also'ed.</phrase></screen>
  4427. </listitem>
  4428. <listitem>
  4429. <para><literal>David Cramer: pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
  4430. </listitem>
  4431. <listitem>
  4432. <para><literal>David Cramer: chunk-common.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
  4433. </listitem>
  4434. <listitem>
  4435. <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.</phrase></screen>
  4436. </listitem>
  4437. <listitem>
  4438. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
  4439. and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
  4440. </listitem>
  4441. <listitem>
  4442. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @xlink:show in the simple.xlink template. The "new" and "replace"
  4443. values are supported (corresponding to values of "_blank" and "_top" for the
  4444. ulink.target parameter). I have assumed that @xlink:show should override ulink.target
  4445. for external URI links. This closes bugs #1762023 and #1727498.</phrase></screen>
  4446. </listitem>
  4447. <listitem>
  4448. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
  4449. </listitem>
  4450. <listitem>
  4451. <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
  4452. </listitem>
  4453. <listitem>
  4454. <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
  4455. </listitem>
  4456. <listitem>
  4457. <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Add support in biblio collection to entries in bibliodivs.</phrase></screen>
  4458. </listitem>
  4459. <listitem>
  4460. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added missing @role="tcg".</phrase></screen>
  4461. </listitem>
  4462. <listitem>
  4463. <para><literal>Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</literal></para><screen><phrase role="commit-message">Refactored legalnotice/revhistory chunking, so that the use.id.as.filename
  4464. parameter as well as the dbhtml_filename PI are taken into account. A new named
  4465. template in titlepage.xsl is used to compute the filename.</phrase></screen>
  4466. </listitem>
  4467. <listitem>
  4468. <para><literal>Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</literal></para><screen><phrase role="commit-message">An update to the fix for bug #1790495 (r7433):
  4469. The "ln-" prefix is output only when the legalnotice doesn't have an
  4470. @id/@xml:id, in which case the stylesheets generate an ID value,
  4471. resulting in a filename like "ln-7e0fwgj.html". This is useful because
  4472. without the prefix, you wouldn't know that the file contained a legalnotice.
  4473. The same logic is also applied to revhistory, using an "rh-" prefix.</phrase></screen>
  4474. </listitem>
  4475. <listitem>
  4476. <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
  4477. This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
  4478. with index.on.type=1. Closes bug #1680836.</phrase></screen>
  4479. </listitem>
  4480. <listitem>
  4481. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the
  4482. &lt;link href"..."&gt; that is output by make.legalnotice.head.links (chunk-common.xsl).
  4483. Modified the href attribute on the legalnotice link.
  4484. Closes bug #1790495.</phrase></screen>
  4485. </listitem>
  4486. </itemizedlist>
  4487. </sect2><!--end of HTML changes for 1.74.0-->
  4488. <sect2 xml:id="V1.74.0_Manpages">
  4489. <title>Manpages</title>
  4490. <para>The following changes have been made to the
  4491. <filename>manpages</filename> code
  4492. since the 1.73.2 release.</para>
  4493. <itemizedlist>
  4494. <listitem>
  4495. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">slightly adjusted spacing around admonition markers</phrase></screen>
  4496. </listitem>
  4497. <listitem>
  4498. <para><literal>Michael(tm) Smith: refentry.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">make sure refsect3 titles are preceded by a line of space, and
  4499. make the indenting of their child content less severe</phrase></screen>
  4500. </listitem>
  4501. <listitem>
  4502. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">only indent verbatim environments in TTY output, not in non-TTY/PS</phrase></screen>
  4503. </listitem>
  4504. <listitem>
  4505. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">made another adjustment to correct vertical alignment of admonition marker</phrase></screen>
  4506. </listitem>
  4507. <listitem>
  4508. <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">Adjusted/corrected alignment of adominition marker in PS/non-TTY output.</phrase></screen>
  4509. </listitem>
  4510. <listitem>
  4511. <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">For PS/non-TTY output, display footnote/endnote numbers in
  4512. superscript.</phrase></screen>
  4513. </listitem>
  4514. <listitem>
  4515. <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
  4516. and synopfragment such that they now look correct in non-TTY/PS
  4517. output. We now use the groff \w escape to hang by the actual width
  4518. -- in the current font -- of the command, funcdef, or
  4519. synopfragment references number (as opposed to hanging by the
  4520. number of characters). This rendering in TTY output remains the
  4521. same, since the width in monospaced TTY output is the same as the
  4522. number of characters.
  4523. Also, created new synopsis-block-start and synopsis-block-end
  4524. templates to use for cmdsynopsis and funcsynopsis instead of the
  4525. corresponding verbatim-* templates.
  4526. Along with those changes, also corrected a problem that caused the
  4527. content of synopfragment to be dropped, and made a
  4528. vertical-spacing change to adjust spacing around table titles and
  4529. among sibling synopfragment instances.</phrase></screen>
  4530. </listitem>
  4531. <listitem>
  4532. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">use common l10.language.name template to retrieve English-language name</phrase></screen>
  4533. </listitem>
  4534. <listitem>
  4535. <para><literal>Michael(tm) Smith: synop.xsl; inline.xsl</literal></para><screen><phrase role="commit-message">added comment in code explaining why we don't put filename output
  4536. in italic (despite the fact that man guidelines say we should)</phrase></screen>
  4537. </listitem>
  4538. <listitem>
  4539. <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">put filename output in monospace instead of italic</phrase></screen>
  4540. </listitem>
  4541. <listitem>
  4542. <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">put cmdsynopsis in monospace</phrase></screen>
  4543. </listitem>
  4544. <listitem>
  4545. <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">removed template match for literal. template matches for monospace
  4546. inlines are all imported from the HTML stylesheet</phrase></screen>
  4547. </listitem>
  4548. <listitem>
  4549. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">don't indent verbatim environments that are descendants of
  4550. refsynopsisdiv, not put backgrounds behind them</phrase></screen>
  4551. </listitem>
  4552. <listitem>
  4553. <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">set output of the literal element in monospace. this causes all
  4554. inline monospace instances in the git man pages to be set in
  4555. monospace (since DocBook XML source for git docs is generated with
  4556. asciidoc and asciidoc consistently outputs only &lt;literal&gt; for
  4557. inline monospace (not &lt;command&gt; or &lt;code&gt; or anything else).
  4558. Of course this only affects non-TTY output...</phrase></screen>
  4559. </listitem>
  4560. <listitem>
  4561. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added inline.monoseq named template.</phrase></screen>
  4562. </listitem>
  4563. <listitem>
  4564. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">don't bother using a custom register to store the previous
  4565. font-family value when setting blocks of text in code font; just
  4566. use \F[] .fam with no arg to switch back</phrase></screen>
  4567. </listitem>
  4568. <listitem>
  4569. <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">put links in blue in PS output (note that this matches how groff
  4570. renders content marked up with the .URL macro)</phrase></screen>
  4571. </listitem>
  4572. <listitem>
  4573. <para><literal>Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">removed man.links.are.underlined and added man.font.links. Also,
  4574. changed the default font formatting for links to bold.</phrase></screen>
  4575. </listitem>
  4576. <listitem>
  4577. <para><literal>Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param man.base.url.for.relative.links .. specifies a
  4578. base URL for relative links (for ulink, @xlink:href, imagedata,
  4579. audiodata, videodata) shown in the generated NOTES section of
  4580. man-page output. The value of man.base.url.for.relative.links is
  4581. prepended to any relative URI that is a value of ulink url,
  4582. xlink:href, or fileref attribute.
  4583. If you use relative URIs in link sources in your DocBook refentry
  4584. source, and you leave man.base.url.for.relative.links unset, the
  4585. relative links will appear "as is" in the NOTES section of any
  4586. man-page output generated from your source. That's probably not
  4587. what you want, because such relative links are only usable in the
  4588. context of HTML output. So, to make the links meaningful and
  4589. usable in the context of man-page output, set a value for
  4590. man.base.url.for.relative.links that points
  4591. to the online version of HTML output generated from your DocBook
  4592. refentry source. For example:
  4593. &lt;xsl:param name="man.base.url.for.relative.links"
  4594. &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
  4595. </listitem>
  4596. <listitem>
  4597. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If a source refentry contains a Documentation or DOCUMENTATION
  4598. section, don't report it as having missing AUTHOR information.
  4599. Also, if missing a contrib/personblurb for a person or org, report
  4600. pointers to http://docbook.sf.net/el/personblurb and to
  4601. http://docbook.sf.net/el/contrib</phrase></screen>
  4602. </listitem>
  4603. <listitem>
  4604. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If we encounter an author|editor|othercredit instance that lacks a
  4605. personblurb or contrib, report it to the user (because that means
  4606. we have no information about that author|editor|othercredit to
  4607. display in the generated AUTHOR|AUTHORS section...)</phrase></screen>
  4608. </listitem>
  4609. <listitem>
  4610. <para><literal>Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl</literal></para><screen><phrase role="commit-message">if we can't find any usable author data, emit a warning and insert
  4611. a fixme in the output</phrase></screen>
  4612. </listitem>
  4613. <listitem>
  4614. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">fixed bug in indenting of output for contrib instances in AUTHORS
  4615. section. Thanks to Daniel Leidert and the fglrx docs for exposing
  4616. the bug.</phrase></screen>
  4617. </listitem>
  4618. <listitem>
  4619. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">for a para or simpara that is the first child of a callout,
  4620. suppress the .sp or .PP that would normally be output (because in
  4621. those cases, the output goes into a table cell, and the .sp or .PP
  4622. markup causes a spurious linebreak before it when displayed</phrase></screen>
  4623. </listitem>
  4624. <listitem>
  4625. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for rendering co callouts and calloutlist instances.
  4626. So you can now use simple callouts -- marking up programlisting
  4627. and such with co instances -- and have the callouts displayed in
  4628. man-page output. ("simple callouts" means using co@id and
  4629. callout@arearefs pointing to co@id instances; in man/roff output,
  4630. we can't/don't support markup that uses areaset and area)</phrase></screen>
  4631. </listitem>
  4632. <listitem>
  4633. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">only put a line of space after a verbatim if it's followed by a
  4634. text node or a paragraph</phrase></screen>
  4635. </listitem>
  4636. <listitem>
  4637. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">put verbatim environments in slightly smaller font in non-TTY
  4638. output</phrase></screen>
  4639. </listitem>
  4640. <listitem>
  4641. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">minor whitespace-only reformatting of lists.xsl source</phrase></screen>
  4642. </listitem>
  4643. <listitem>
  4644. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Made refinements/fixes to output of orderedlist and itemizedlist
  4645. -- in part, to get mysql man pages to display correctly. This
  4646. change causes a "\c" continuation marker to be added between
  4647. listitem markers and contents (to ensure that the content remains
  4648. on the same line as the marker when displayed)</phrase></screen>
  4649. </listitem>
  4650. <listitem>
  4651. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put a line of vertical space after all verbatim output that has
  4652. sibling content following it (not just if that sibling content is
  4653. a text node)</phrase></screen>
  4654. </listitem>
  4655. <listitem>
  4656. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">refined spacing around titles for admonitions</phrase></screen>
  4657. </listitem>
  4658. <listitem>
  4659. <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">Deal with case of verbatim environments that have a linebreak
  4660. after the opening tag. Assumption is that users generally don't
  4661. want that linebreak to appear in output, so we do some groff
  4662. hackery to mess with vertical spacing and close the space.</phrase></screen>
  4663. </listitem>
  4664. <listitem>
  4665. <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">indexterm instances now produce groff comments like this:
  4666. .\" primary: secondary: tertiary
  4667. remark instances, if non-empty, now produce groff comments</phrase></screen>
  4668. </listitem>
  4669. <listitem>
  4670. <para><literal>Michael(tm) Smith: charmap.groff.xsl; other.xsl</literal></para><screen><phrase role="commit-message">convert no-break space character to groff "\ \&amp;" (instead of just
  4671. "\ "). the reason is that if a space occurs at the end of a line,
  4672. our processing causes it to be eaten. a real-world case of this is
  4673. the mysql(1) man page. appending the "\&amp;" prevents that</phrase></screen>
  4674. </listitem>
  4675. <listitem>
  4676. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">output "sp" before simpara output, not after it (outputting it
  4677. after results in undesirable whitespace in particular cases; for
  4678. example, in the hg/mercurial docs</phrase></screen>
  4679. </listitem>
  4680. <listitem>
  4681. <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">renamed from title-preamble to pinch.together and replaced "sp -1"
  4682. between synopsis fragments with call to pinch.together instead</phrase></screen>
  4683. </listitem>
  4684. <listitem>
  4685. <para><literal>Michael(tm) Smith: table.xsl</literal></para><screen><phrase role="commit-message">use title-preamble template for table titles (instead of "sp -1"
  4686. hack), and "sp 1" after all tables (instead of just "sp"</phrase></screen>
  4687. </listitem>
  4688. <listitem>
  4689. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created title-preamble template for suppressing line spacing after
  4690. headings</phrase></screen>
  4691. </listitem>
  4692. <listitem>
  4693. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">further refinement of indenting in AUTHORS section</phrase></screen>
  4694. </listitem>
  4695. <listitem>
  4696. <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">refined handling of admonitions</phrase></screen>
  4697. </listitem>
  4698. <listitem>
  4699. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Use RS/RE in another place where we had IP ""</phrase></screen>
  4700. </listitem>
  4701. <listitem>
  4702. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
  4703. instead.</phrase></screen>
  4704. </listitem>
  4705. <listitem>
  4706. <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; info.xsl</literal></para><screen><phrase role="commit-message">changed all instances of ".sp -1n" to ".sp -1"</phrase></screen>
  4707. </listitem>
  4708. <listitem>
  4709. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">add extra line before SH heads only in non-TTY output</phrase></screen>
  4710. </listitem>
  4711. <listitem>
  4712. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Reworked output for admonitions (caution, important, note, tip,
  4713. warning). In TTY output, admonitions now get indented. In non-TTY
  4714. output, a colored marker (yellow) is displayed next to them.</phrase></screen>
  4715. </listitem>
  4716. <listitem>
  4717. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Added BM/EM macros for putting a colored marker in margin next to
  4718. a block of text.</phrase></screen>
  4719. </listitem>
  4720. <listitem>
  4721. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created make.bold.title template by moving title-bolding part out
  4722. from nested-section-title template. This allows the bolding to
  4723. also be used by the template for formatting admonitions</phrase></screen>
  4724. </listitem>
  4725. <listitem>
  4726. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">put .br before copyright contents to prevent them from getting run in</phrase></screen>
  4727. </listitem>
  4728. <listitem>
  4729. <para><literal>Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">made point size of output for Refsect2 and Refsect3 heads bigger</phrase></screen>
  4730. </listitem>
  4731. <listitem>
  4732. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">put slightly more space between SH head and underline in non-TTY
  4733. output</phrase></screen>
  4734. </listitem>
  4735. <listitem>
  4736. <para><literal>Michael(tm) Smith: param.xweb; param.ent; other.xsl</literal></para><screen><phrase role="commit-message">Added the man.charmap.subset.profile.english parameter and refined
  4737. the handling of charmap subsets to differentiate between English
  4738. and non-English source.
  4739. This way charmap subsets are now handled is this:
  4740. If the value of the man.charmap.use.subset parameter is non-zero,
  4741. and your DocBook source is not written in English (that is, if its
  4742. lang or xml:lang attribute has a value other than en), then the
  4743. character-map subset specified by the man.charmap.subset.profile
  4744. parameter is used instead of the full roff character map.
  4745. Otherwise, if the lang or xml:lang attribute on the root element
  4746. in your DocBook source or on the first refentry element in your
  4747. source has the value en or if it has no lang or xml:lang
  4748. attribute, then the character-map subset specified by the
  4749. man.charmap.subset.profile.english parameter is used instead of
  4750. man.charmap.subset.profile.
  4751. The difference between the two subsets is that
  4752. man.charmap.subset.profile provides mappings for characters in
  4753. Western European languages that are not part of the Roman
  4754. (English) alphabet (ASCII character set).</phrase></screen>
  4755. </listitem>
  4756. <listitem>
  4757. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Various updates, mainly related to uppercasing SH titles:
  4758. - added a "Language: " metadata line to the top comment area of
  4759. output man pages, to indicate the language the page is in
  4760. - added a "toupper" macro of doing locale-aware uppercasing of
  4761. SH titles and cross-references to SH titles; the mechanism
  4762. relies on the uppercase.alpha and lowercase.alpha DocBook
  4763. gentext keys to do locale-aware uppercasing based on the
  4764. language the page is written in
  4765. - added a "string.shuffle" template, which provides a library
  4766. function for "shuffling" two strings together into a single
  4767. string; it takes the first character for the first string, the
  4768. first character from second string, etc. The only current use
  4769. for it is to generate the argument for the groff tr request
  4770. that does string uppercasing.
  4771. - added make.tr.uppercase.arg and make.tr.normalcase.arg named
  4772. templates for use in generating groff code for uppercasing and
  4773. "normal"-casing SH titles
  4774. - made the BB/BE "background drawing" macros have effect only in
  4775. non-TTY output
  4776. - output a few comments in the top part of source</phrase></screen>
  4777. </listitem>
  4778. <listitem>
  4779. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">removed some leftover kruft</phrase></screen>
  4780. </listitem>
  4781. <listitem>
  4782. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">To create the name(s) for each man page, we now replace any spaces
  4783. in the refname(s) with underscores. This ensures that tools like
  4784. lexgrog(1) will be able to parse the name (lexgrog won't parse
  4785. names that contain spaces).</phrase></screen>
  4786. </listitem>
  4787. <listitem>
  4788. <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Put a comment into source of man page to indicate where the main
  4789. content starts. (We now have a few of macro definitions at the
  4790. start of the source, so putting this comment in helps those that
  4791. might be viewing the source.)</phrase></screen>
  4792. </listitem>
  4793. <listitem>
  4794. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined mechanism for generating SH titles</phrase></screen>
  4795. </listitem>
  4796. <listitem>
  4797. <para><literal>Michael(tm) Smith: charmap.groff.xsl</literal></para><screen><phrase role="commit-message">Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
  4798. This means that generated Finnish man pages will no longer contain
  4799. any raw accented characters -- they'll instead by marked up with
  4800. groff escapes.</phrase></screen>
  4801. </listitem>
  4802. <listitem>
  4803. <para><literal>Michael(tm) Smith: other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">corrected a regression I introduced about a year ago that caused
  4804. dots to be output just as "\." -- instead needs to be "\&amp;." (which
  4805. is what it will be now, after this change)</phrase></screen>
  4806. </listitem>
  4807. <listitem>
  4808. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Changed backend handling for generating titles for SH sections and
  4809. for cross-references to those sections. This should have no effect
  4810. on TTY output (behavior should remain the same hopefully) but
  4811. results in titles in normal case (instead of uppercase) in PS
  4812. output.</phrase></screen>
  4813. </listitem>
  4814. <listitem>
  4815. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">use make.subheading template to make subheadings for AUTHORS and
  4816. COPYRIGHT sections (instead of harcoding roff markup)</phrase></screen>
  4817. </listitem>
  4818. <listitem>
  4819. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put code font around programlisting etc.</phrase></screen>
  4820. </listitem>
  4821. <listitem>
  4822. <para><literal>Michael(tm) Smith: synop.xsl; docbook.xsl</literal></para><screen><phrase role="commit-message">embed custom macro definitions in man pages, plus wrap synopsis in
  4823. code font</phrase></screen>
  4824. </listitem>
  4825. <listitem>
  4826. <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">use the make.subheading template to generated SH subheading for
  4827. endnotes section.</phrase></screen>
  4828. </listitem>
  4829. <listitem>
  4830. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added some templates for generating if-then-else conditional
  4831. markup in groff, so let's use those instead of hard-coding it in
  4832. multiple places...</phrase></screen>
  4833. </listitem>
  4834. <listitem>
  4835. <para><literal>Michael(tm) Smith: other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">Initial checkin of some changes related to making PS/PDF output
  4836. from "man -l -Tps" look better. The current changes:
  4837. - render synopsis and verbatim sections in a monospace/code font
  4838. - put a light-grey background behind all programlisting, screen,
  4839. and literallayout instances
  4840. - prevent SH heads in PS output from being rendered in uppercase
  4841. (as they are in console output)
  4842. - also display xrefs to SH heads in PS output in normal case
  4843. (instead of uppercase)
  4844. - draw a line under SH heads in PS output
  4845. The changes made to the code to support the above features were:
  4846. - added some embedded/custom macros: one for conditionally
  4847. upper-casing SH x-refs, one for redefining the SH macro
  4848. itself, with some conditional handling for PS output, and
  4849. finally a macro for putting a background/screen (filled box)
  4850. around a block of text (e.g., a program listing) in PS output
  4851. - added utility templates for wrapping blocks of text in code
  4852. font; also templates for inline code font</phrase></screen>
  4853. </listitem>
  4854. <listitem>
  4855. <para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">refpurpose nodes now get apply-templates instead of just normalize-space().</phrase></screen>
  4856. </listitem>
  4857. <listitem>
  4858. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed alignment of first lined of text for each listitem in
  4859. orderedlist output for TTY. Existing code seemed to have been
  4860. causing an extra undesirable space to appear.</phrase></screen>
  4861. </listitem>
  4862. <listitem>
  4863. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Wrapped some roff conditionals around roff markup for orderedlist
  4864. and itemizedlist output, so that the lists look acceptable in PS
  4865. output as well as TTY.</phrase></screen>
  4866. </listitem>
  4867. <listitem>
  4868. <para><literal>Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added the man.funcsynopsis.style parameter. Has the same effect in
  4869. manpages output as the funcsynopsis.style parameter has in HTML
  4870. output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
  4871. </listitem>
  4872. <listitem>
  4873. <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
  4874. on the HTML kr-tabular templates, but instead just does direct
  4875. transformation to roff. For K&amp;R output, it displays the paramdef
  4876. output in an indented list following the prototype.</phrase></screen>
  4877. </listitem>
  4878. <listitem>
  4879. <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Properly integrated handling for K&amp;R output into manpages
  4880. stylesheet. The choice between K&amp;R output and ANSI output is
  4881. currently controlled through use of the (HTML) funcsynopsis.style
  4882. parameter. Note that because the mechanism does currently rely on
  4883. funcsynopsis.style, the default in manpages output is now K&amp;R
  4884. (because that's the default of that param). But I suppose I ought
  4885. to create a man.funcsynopsis.style and make the default for that
  4886. ANSI (to preserve the existing default behavior).</phrase></screen>
  4887. </listitem>
  4888. <listitem>
  4889. <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added manpages/pi.xsl file</phrase></screen>
  4890. </listitem>
  4891. <listitem>
  4892. <para><literal>Michael(tm) Smith: .cvsignore; pi.xsl</literal></para><screen><phrase role="commit-message">Added "dbman funcsynopsis-style" PI and incorporated it into the
  4893. doc build.</phrase></screen>
  4894. </listitem>
  4895. <listitem>
  4896. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed regression that caused an unescaped dash to be output
  4897. between refname and refpurpose content. Closes bug #1894244.
  4898. Thanks to Daniel Leidert.</phrase></screen>
  4899. </listitem>
  4900. <listitem>
  4901. <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with dots being escaped in filenames of generated
  4902. man files. Closes #1827195. Thanks to Daniel Leidert.</phrase></screen>
  4903. </listitem>
  4904. <listitem>
  4905. <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for processing structfield (was appearing in roff
  4906. output surrounded by HTML &lt;em&gt; tags; fixed so that it gets roff
  4907. ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.</phrase></screen>
  4908. </listitem>
  4909. </itemizedlist>
  4910. </sect2><!--end of Manpages changes for 1.74.0-->
  4911. <sect2 xml:id="V1.74.0_Epub">
  4912. <title>Epub</title>
  4913. <para>The following changes have been made to the
  4914. <filename>epub</filename> code
  4915. since the 1.73.2 release.</para>
  4916. <itemizedlist>
  4917. <listitem> <para><literal>Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb</literal></para><screen><phrase role="commit-message">'Realbook' spec now passes</phrase></screen> </listitem>
  4918. <listitem> <para><literal>Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb; bin/spec/epub_r&#x22EF;</literal></para><screen><phrase role="commit-message">Very primitive Windows support for dbtoepub <tag>reference</tag> implementation; README for running tests and for the .epub target in general; shorter realbook test document (still fails for now)</phrase></screen> </listitem>
  4919. <listitem> <para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s&#x22EF;</literal></para><screen><phrase role="commit-message">Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same</phrase></screen> </listitem>
  4920. <listitem> <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixing linking to <tag>cover</tag> @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)</phrase></screen> </listitem>
  4921. <listitem> <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Updating the <tag>title</tag> of the <tag>toc</tag> element in the guide to be more explicit (thanks to Martin Goerner)</phrase></screen> </listitem>
  4922. <listitem>
  4923. <para><literal>Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/examples/amasque_&#x22EF;</literal></para><screen><phrase role="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
  4924. and Keith Fahlgren of O'Reilly.</phrase></screen>
  4925. </listitem>
  4926. <listitem>
  4927. <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">== General epub test support
  4928. $ spec -O ~/.spec.opts spec/epub_spec.rb
  4929. DocBook::Epub
  4930. - should be able to be created
  4931. - should fail on a nonexistent file
  4932. - should be able to render to a file
  4933. - should create a file after rendering
  4934. - should have the correct mimetype after rendering
  4935. - should be valid .epub after rendering an article
  4936. - should be valid .epub after rendering an article without sections
  4937. - should be valid .epub after rendering a book
  4938. - should be valid .epub after rendering a book even if it has one graphic
  4939. - should be valid .epub after rendering a book even if it has many graphics
  4940. - should be valid .epub after rendering a book even if it has many duplicated graphics
  4941. - should report an empty file as invalid
  4942. - should confirm that a valid .epub file is valid
  4943. - should not include PDFs in rendered epub files as valid image inclusions
  4944. - should include a TOC link in rendered epub files for &lt;book&gt;s
  4945. Finished in 20.608395 seconds
  4946. 15 examples, 0 failures
  4947. == Verbose epub test coverage against _all_ of the testdocs
  4948. Fails on only (errors truncated):
  4949. 1)
  4950. 'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/calloutlist.003.xml [30]' FAILED
  4951. 'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/cmdsynopsis.001.xml [35]' FAILED
  4952. ....
  4953. Finished in 629.89194 seconds
  4954. 224 examples, 15 failures
  4955. 224 examples, 15 failures yields 6% failure rate</phrase></screen>
  4956. </listitem>
  4957. </itemizedlist>
  4958. </sect2><!--end of Epub changes for 1.74.0-->
  4959. <sect2 xml:id="V1.74.0_HTMLHelp">
  4960. <title>HTMLHelp</title>
  4961. <para>The following changes have been made to the
  4962. <filename>htmlhelp</filename> code
  4963. since the 1.73.2 release.</para>
  4964. <itemizedlist>
  4965. <listitem>
  4966. <para><literal>Mauritz Jeanson: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
  4967. the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
  4968. This makes chunk.quietly=1 suppress chunk filename messages also for help
  4969. support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
  4970. </listitem>
  4971. </itemizedlist>
  4972. </sect2><!--end of HTMLHelp changes for 1.74.0-->
  4973. <sect2 xml:id="V1.74.0_Eclipse">
  4974. <title>Eclipse</title>
  4975. <para>The following changes have been made to the
  4976. <filename>eclipse</filename> code
  4977. since the 1.73.2 release.</para>
  4978. <itemizedlist>
  4979. <listitem>
  4980. <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Use sortas attributes (if they exist) when sorting indexterms</phrase></screen>
  4981. </listitem>
  4982. <listitem>
  4983. <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added support for indexterm/see in eclipse index.xml</phrase></screen>
  4984. </listitem>
  4985. <listitem>
  4986. <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt;
  4987. to helpidx template.</phrase></screen>
  4988. </listitem>
  4989. <listitem>
  4990. <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.</phrase></screen>
  4991. </listitem>
  4992. <listitem>
  4993. <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
  4994. the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
  4995. This makes chunk.quietly=1 suppress chunk filename messages also for help
  4996. support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
  4997. </listitem>
  4998. </itemizedlist>
  4999. </sect2><!--end of Eclipse changes for 1.74.0-->
  5000. <sect2 xml:id="V1.74.0_JavaHelp">
  5001. <title>JavaHelp</title>
  5002. <para>The following changes have been made to the
  5003. <filename>javahelp</filename> code
  5004. since the 1.73.2 release.</para>
  5005. <itemizedlist>
  5006. <listitem>
  5007. <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
  5008. the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
  5009. This makes chunk.quietly=1 suppress chunk filename messages also for help
  5010. support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
  5011. </listitem>
  5012. </itemizedlist>
  5013. </sect2><!--end of JavaHelp changes for 1.74.0-->
  5014. <sect2 xml:id="V1.74.0_Roundtrip">
  5015. <title>Roundtrip</title>
  5016. <para>The following changes have been made to the
  5017. <filename>roundtrip</filename> code
  5018. since the 1.73.2 release.</para>
  5019. <itemizedlist>
  5020. <listitem>
  5021. <para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">fix table/cell borders for wordml, fix formal figure, add emphasis-strong</phrase></screen>
  5022. </listitem>
  5023. <listitem>
  5024. <para><literal>Mauritz Jeanson: supported.xml</literal></para><screen><phrase role="commit-message">Changed @cols to 5.</phrase></screen>
  5025. </listitem>
  5026. <listitem>
  5027. <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</literal></para><screen><phrase role="commit-message">added pubdate, fixed metadata handling in biblioentry</phrase></screen>
  5028. </listitem>
  5029. <listitem>
  5030. <para><literal>Steve Ball: supported.xml</literal></para><screen><phrase role="commit-message">Added support for edition.</phrase></screen>
  5031. </listitem>
  5032. <listitem>
  5033. <para><literal>Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl; pages-normalise&#x22EF;</literal></para><screen><phrase role="commit-message">Removed stylesheets for old, deprecated conversion method.</phrase></screen>
  5034. </listitem>
  5035. <listitem>
  5036. <para><literal>Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl; blocks2dbk.dtd&#x22EF;</literal></para><screen><phrase role="commit-message">Added support for Open Office, added edition element, improved list and table support in Word and Pages</phrase></screen>
  5037. </listitem>
  5038. <listitem>
  5039. <para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl; template-pages.xml; templ&#x22EF;</literal></para><screen><phrase role="commit-message">Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.</phrase></screen>
  5040. </listitem>
  5041. <listitem>
  5042. <para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">fix caption, attributes</phrase></screen>
  5043. </listitem>
  5044. <listitem>
  5045. <para><literal>Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl; blocks2dbk.dtd; temp&#x22EF;</literal></para><screen><phrase role="commit-message">Fixes to table and list handling</phrase></screen>
  5046. </listitem>
  5047. <listitem>
  5048. <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">added support for explicit emphasis character styles</phrase></screen>
  5049. </listitem>
  5050. <listitem>
  5051. <para><literal>Steve Ball: wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for customisation in image handling</phrase></screen>
  5052. </listitem>
  5053. <listitem>
  5054. <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">Added inlinemediaobject support for metadata.</phrase></screen>
  5055. </listitem>
  5056. <listitem>
  5057. <para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml; dbk2wordml.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">Added support file. Added style locking. Conversion bug fixes.</phrase></screen>
  5058. </listitem>
  5059. </itemizedlist>
  5060. </sect2><!--end of Roundtrip changes for 1.74.0-->
  5061. <sect2 xml:id="V1.74.0_Slides">
  5062. <title>Slides</title>
  5063. <para>The following changes have been made to the
  5064. <filename>slides</filename> code
  5065. since the 1.73.2 release.</para>
  5066. <itemizedlist>
  5067. <listitem>
  5068. <para><literal>Michael(tm) Smith: fo/Makefile; html/Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
  5069. under Cygwin. This stuff is ugly and maybe not worth the mess and
  5070. trouble, but does seem to work as expected and not break anything
  5071. else.</phrase></screen>
  5072. </listitem>
  5073. <listitem>
  5074. <para><literal>Jirka Kosek: html/plain.xsl</literal></para><screen><phrase role="commit-message">Added support for showing foil number</phrase></screen>
  5075. </listitem>
  5076. </itemizedlist>
  5077. </sect2><!--end of Slides changes for 1.74.0-->
  5078. <sect2 xml:id="V1.74.0_Website">
  5079. <title>Website</title>
  5080. <para>The following changes have been made to the
  5081. <filename>website</filename> code
  5082. since the 1.73.2 release.</para>
  5083. <itemizedlist>
  5084. <listitem>
  5085. <para><literal>Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/xalan2/.classes/com/&#x22EF;</literal></para><screen><phrase role="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</phrase></screen>
  5086. </listitem>
  5087. </itemizedlist>
  5088. </sect2><!--end of Website changes for 1.74.0-->
  5089. <sect2 xml:id="V1.74.0_Params">
  5090. <title>Params</title>
  5091. <para>The following changes have been made to the
  5092. <filename>params</filename> code
  5093. since the 1.73.2 release.</para>
  5094. <itemizedlist>
  5095. <listitem> <para><literal>Keith Fahlgren: epub.autolabel.xml</literal></para><screen><phrase role="commit-message">New parameter for epub, epub.autolabel</phrase></screen> </listitem>
  5096. <listitem>
  5097. <para><literal>Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml; table.cell.border.t&#x22EF;</literal></para><screen><phrase role="commit-message">Added missing refpurposes and descriptions.</phrase></screen>
  5098. </listitem>
  5099. <listitem>
  5100. <para><literal>Keith Fahlgren: ade.extensions.xml</literal></para><screen><phrase role="commit-message">Extensions to support Adobe Digital Editions extensions in .epub output.</phrase></screen>
  5101. </listitem>
  5102. <listitem>
  5103. <para><literal>Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml</literal></para><screen><phrase role="commit-message">Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...</phrase></screen>
  5104. </listitem>
  5105. <listitem>
  5106. <para><literal>Michael(tm) Smith: man.links.are.underlined.xml; man.endnotes.list.enabled.xml; man.font.l&#x22EF;</literal></para><screen><phrase role="commit-message">removed man.links.are.underlined and added man.font.links. Also,
  5107. changed the default font formatting for links to bold.</phrase></screen>
  5108. </listitem>
  5109. <listitem>
  5110. <para><literal>Michael(tm) Smith: man.base.url.for.relative.links.xml</literal></para><screen><phrase role="commit-message">Added new param man.base.url.for.relative.links .. specifies a
  5111. base URL for relative links (for ulink, @xlink:href, imagedata,
  5112. audiodata, videodata) shown in the generated NOTES section of
  5113. man-page output. The value of man.base.url.for.relative.links is
  5114. prepended to any relative URI that is a value of ulink url,
  5115. xlink:href, or fileref attribute.
  5116. If you use relative URIs in link sources in your DocBook refentry
  5117. source, and you leave man.base.url.for.relative.links unset, the
  5118. relative links will appear "as is" in the NOTES section of any
  5119. man-page output generated from your source. That's probably not
  5120. what you want, because such relative links are only usable in the
  5121. context of HTML output. So, to make the links meaningful and
  5122. usable in the context of man-page output, set a value for
  5123. man.base.url.for.relative.links that points
  5124. to the online version of HTML output generated from your DocBook
  5125. refentry source. For example:
  5126. &lt;xsl:param name="man.base.url.for.relative.links"
  5127. &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
  5128. </listitem>
  5129. <listitem>
  5130. <para><literal>Michael(tm) Smith: man.string.subst.map.xml</literal></para><screen><phrase role="commit-message">squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
  5131. line of whitespace from being inserted after programlisting etc.
  5132. in certain cases)</phrase></screen>
  5133. </listitem>
  5134. <listitem>
  5135. <para><literal>Michael(tm) Smith: refentry.manual.fallback.profile.xml; refentry.source.fallback.profile.&#x22EF;</literal></para><screen><phrase role="commit-message">don't use refmiscinfo@class=date value as fallback for refentry
  5136. "source" or "manual" metadata fields</phrase></screen>
  5137. </listitem>
  5138. <listitem>
  5139. <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su&#x22EF;</literal></para><screen><phrase role="commit-message">made some further doc tweaks related to the
  5140. man.charmap.subset.profile.english param</phrase></screen>
  5141. </listitem>
  5142. <listitem>
  5143. <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su&#x22EF;</literal></para><screen><phrase role="commit-message">Added the man.charmap.subset.profile.english parameter and refined
  5144. the handling of charmap subsets to differentiate between English
  5145. and non-English source.
  5146. This way charmap subsets are now handled is this:
  5147. If the value of the man.charmap.use.subset parameter is non-zero,
  5148. and your DocBook source is not written in English (that is, if its
  5149. lang or xml:lang attribute has a value other than en), then the
  5150. character-map subset specified by the man.charmap.subset.profile
  5151. parameter is used instead of the full roff character map.
  5152. Otherwise, if the lang or xml:lang attribute on the root element
  5153. in your DocBook source or on the first refentry element in your
  5154. source has the value en or if it has no lang or xml:lang
  5155. attribute, then the character-map subset specified by the
  5156. man.charmap.subset.profile.english parameter is used instead of
  5157. man.charmap.subset.profile.
  5158. The difference between the two subsets is that
  5159. man.charmap.subset.profile provides mappings for characters in
  5160. Western European languages that are not part of the Roman
  5161. (English) alphabet (ASCII character set).</phrase></screen>
  5162. </listitem>
  5163. <listitem>
  5164. <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml</literal></para><screen><phrase role="commit-message">Added to default charmap used by manpages:
  5165. - the "letters" part of the 'C1 Controls And Latin-1 Supplement
  5166. (Latin-1 Supplement)' Unicode block
  5167. - Latin Extended-A block (but not all of the characters from
  5168. that block have mappings in groff, so some of them are still
  5169. passed through as-is)
  5170. The effects of this change are that in man pages generated for
  5171. most Western European languages and for Finnish, all characters
  5172. not part of the Roman alphabet are (e.g., "accented" characters)
  5173. are converted to groff escapes.
  5174. Previously, by default we passed through those characters as is
  5175. (and users needed to use the full charmap if they wanted to have
  5176. those characters converted).
  5177. As a result of this change, man pages generated for Western
  5178. European languages will be viewable in some environments in which
  5179. they are not viewable if the "raw" non-Roman characters are in them.</phrase></screen>
  5180. </listitem>
  5181. <listitem>
  5182. <para><literal>Mauritz Jeanson: generate.legalnotice.link.xml; generate.revhistory.link.xml</literal></para><screen><phrase role="commit-message">Added information on how the filename is computed.</phrase></screen>
  5183. </listitem>
  5184. <listitem>
  5185. <para><literal>Mauritz Jeanson: default.table.width.xml</literal></para><screen><phrase role="commit-message">Clarified PI usage.</phrase></screen>
  5186. </listitem>
  5187. <listitem>
  5188. <para><literal>Michael(tm) Smith: man.funcsynopsis.style.xml</literal></para><screen><phrase role="commit-message">Added the man.funcsynopsis.style parameter. Has the same effect in
  5189. manpages output as the funcsynopsis.style parameter has in HTML
  5190. output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
  5191. </listitem>
  5192. <listitem>
  5193. <para><literal>Michael(tm) Smith: funcsynopsis.tabular.threshold.xml</literal></para><screen><phrase role="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
  5194. being used in the code and hasn't been since mid 2006.</phrase></screen>
  5195. </listitem>
  5196. <listitem>
  5197. <para><literal>Mauritz Jeanson: table.properties.xml</literal></para><screen><phrase role="commit-message">Set keep-together.within-column to "auto". This seems to be the most sensible
  5198. default value for tables.</phrase></screen>
  5199. </listitem>
  5200. <listitem>
  5201. <para><literal>Mauritz Jeanson: informal.object.properties.xml; admon.graphics.extension.xml; informalequ&#x22EF;</literal></para><screen><phrase role="commit-message">Several small documentation fixes.</phrase></screen>
  5202. </listitem>
  5203. <listitem>
  5204. <para><literal>Mauritz Jeanson: manifest.in.base.dir.xml</literal></para><screen><phrase role="commit-message">Wording fixes.</phrase></screen>
  5205. </listitem>
  5206. <listitem>
  5207. <para><literal>Mauritz Jeanson: header.content.properties.xml; footer.content.properties.xml</literal></para><screen><phrase role="commit-message">Added refpurpose.</phrase></screen>
  5208. </listitem>
  5209. <listitem>
  5210. <para><literal>Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml</literal></para><screen><phrase role="commit-message">Updated for DocBook 5.</phrase></screen>
  5211. </listitem>
  5212. <listitem>
  5213. <para><literal>Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml</literal></para><screen><phrase role="commit-message">Spelling and wording fixes.</phrase></screen>
  5214. </listitem>
  5215. <listitem>
  5216. <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarifed available graphics formats and extensions.</phrase></screen>
  5217. </listitem>
  5218. <listitem>
  5219. <para><literal>Mauritz Jeanson: footnote.sep.leader.properties.xml</literal></para><screen><phrase role="commit-message">Corrected refpurpose.</phrase></screen>
  5220. </listitem>
  5221. <listitem>
  5222. <para><literal>Jirka Kosek: footnote.properties.xml</literal></para><screen><phrase role="commit-message">Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.</phrase></screen>
  5223. </listitem>
  5224. <listitem>
  5225. <para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">img.src.path works with inlinegraphic too.</phrase></screen>
  5226. </listitem>
  5227. <listitem>
  5228. <para><literal>Mauritz Jeanson: saxon.character.representation.xml</literal></para><screen><phrase role="commit-message">Added TCG link.</phrase></screen>
  5229. </listitem>
  5230. <listitem>
  5231. <para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">Updated description of img.src.path. Bug #1785224 revealed that
  5232. there was a risk of misunderstanding how it works.</phrase></screen>
  5233. </listitem>
  5234. </itemizedlist>
  5235. </sect2><!--end of Params changes for 1.74.0-->
  5236. <sect2 xml:id="V1.74.0_Profiling">
  5237. <title>Profiling</title>
  5238. <para>The following changes have been made to the
  5239. <filename>profiling</filename> code
  5240. since the 1.73.2 release.</para>
  5241. <itemizedlist>
  5242. <listitem>
  5243. <para><literal>Jirka Kosek: xsl2profile.xsl</literal></para><screen><phrase role="commit-message">Added new rules to profile all content generated by HTML Help (including alias files)</phrase></screen>
  5244. </listitem>
  5245. <listitem>
  5246. <para><literal>Robert Stayton: profile-mode.xsl</literal></para><screen><phrase role="commit-message">use mode="profile" instead of xsl:copy-of for attributes so
  5247. they can be more easily customized.</phrase></screen>
  5248. </listitem>
  5249. </itemizedlist>
  5250. </sect2><!--end of Profiling changes for 1.74.0-->
  5251. <sect2 xml:id="V1.74.0_Tools">
  5252. <title>Tools</title>
  5253. <para>The following changes have been made to the
  5254. <filename>tools</filename> code
  5255. since the 1.73.2 release.</para>
  5256. <itemizedlist>
  5257. <listitem>
  5258. <para><literal>Michael(tm) Smith: make/Makefile.DocBook</literal></para><screen><phrase role="commit-message">various changes and additions to support making with asciidoc as
  5259. an input format</phrase></screen>
  5260. </listitem>
  5261. <listitem>
  5262. <para><literal>Michael(tm) Smith: make/Makefile.DocBook</literal></para><screen><phrase role="commit-message">make dblatex the default PDF maker for the example makefile</phrase></screen>
  5263. </listitem>
  5264. <listitem>
  5265. <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
  5266. on the HTML kr-tabular templates, but instead just does direct
  5267. transformation to roff. For K&amp;R output, it displays the paramdef
  5268. output in an indented list following the prototype.</phrase></screen>
  5269. </listitem>
  5270. <listitem>
  5271. <para><literal>Mauritz Jeanson: xsl/build/make-xsl-params.xsl</literal></para><screen><phrase role="commit-message">Made attribute-sets members of the param list. This enables links to attribute-sets in the
  5272. reference documentation.</phrase></screen>
  5273. </listitem>
  5274. <listitem>
  5275. <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">use .BI handling in K&amp;R funsynopsis output for manpages, just as
  5276. we do already of ANSI output</phrase></screen>
  5277. </listitem>
  5278. <listitem>
  5279. <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Implemented initial support for handling tabular K&amp;R output of
  5280. funcprototype in manpages output. Accomplished by adding more
  5281. templates to the intermediate HTML-to-roff stylesheet that the
  5282. build uses to create the manpages/html-synop.xsl stylesheet.</phrase></screen>
  5283. </listitem>
  5284. <listitem>
  5285. <para><literal>Michael(tm) Smith: xsl/build/doc-link-docbook.xsl</literal></para><screen><phrase role="commit-message">Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
  5286. import profile-docbook.xsl, so that we can do profiling of release
  5287. notes. Corrected some problems in the target for the release-notes
  5288. HTML build.</phrase></screen>
  5289. </listitem>
  5290. </itemizedlist>
  5291. </sect2><!--end of Tools changes for 1.74.0-->
  5292. <sect2 xml:id="V1.74.0_Extensions">
  5293. <title>Extensions</title>
  5294. <para>The following changes have been made to the
  5295. <filename>extensions</filename> code
  5296. since the 1.73.2 release.</para>
  5297. <itemizedlist>
  5298. <listitem> <para><literal>Keith Fahlgren: Makefile</literal></para><screen><phrase role="commit-message">Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER</phrase></screen> </listitem>
  5299. <listitem>
  5300. <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">moved extensions build targets from master xsl/Makefile to
  5301. xsl/extensions/Makefile</phrase></screen>
  5302. </listitem>
  5303. <listitem>
  5304. <para><literal>Michael(tm) Smith: .cvsignore</literal></para><screen><phrase role="commit-message">re-adding empty extensions subdir</phrase></screen>
  5305. </listitem>
  5306. </itemizedlist>
  5307. </sect2><!--end of Extensions changes for 1.74.0-->
  5308. <sect2 xml:id="V1.74.0_XSL-Saxon">
  5309. <title>XSL-Saxon</title>
  5310. <para>The following changes have been made to the
  5311. <filename>xsl-saxon</filename> code
  5312. since the 1.73.2 release.</para>
  5313. <itemizedlist>
  5314. <listitem>
  5315. <para><literal>Michael(tm) Smith: VERSION</literal></para><screen><phrase role="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
  5316. recent change to snapshot build infrastructure</phrase></screen>
  5317. </listitem>
  5318. <listitem>
  5319. <para><literal>Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties</literal></para><screen><phrase role="commit-message">Changed hard-coded file references in "clean" target to variable
  5320. references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
  5321. </listitem>
  5322. <listitem>
  5323. <para><literal>Michael(tm) Smith: VERSION; Makefile</literal></para><screen><phrase role="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</phrase></screen>
  5324. </listitem>
  5325. <listitem>
  5326. <para><literal>Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test</literal></para><screen><phrase role="commit-message">More tweaks to get release-ready</phrase></screen>
  5327. </listitem>
  5328. </itemizedlist>
  5329. </sect2><!--end of XSL-Saxon changes for 1.74.0-->
  5330. <sect2 xml:id="V1.74.0_XSL-Xalan">
  5331. <title>XSL-Xalan</title>
  5332. <para>The following changes have been made to the
  5333. <filename>xsl-xalan</filename> code
  5334. since the 1.73.2 release.</para>
  5335. <itemizedlist>
  5336. <listitem>
  5337. <para><literal>Michael(tm) Smith: VERSION</literal></para><screen><phrase role="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
  5338. recent change to snapshot build infrastructure</phrase></screen>
  5339. </listitem>
  5340. <listitem>
  5341. <para><literal>Michael(tm) Smith: nbproject/build-impl.xml</literal></para><screen><phrase role="commit-message">Changed hard-coded file references in "clean" target to variable
  5342. references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
  5343. </listitem>
  5344. <listitem>
  5345. <para><literal>Michael(tm) Smith: Makefile; VERSION</literal></para><screen><phrase role="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</phrase></screen>
  5346. </listitem>
  5347. <listitem>
  5348. <para><literal>Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION</literal></para><screen><phrase role="commit-message">More tweaks to get release-ready</phrase></screen>
  5349. </listitem>
  5350. </itemizedlist>
  5351. </sect2><!--end of XSL-Xalan changes for 1.74.0-->
  5352. <sect2 xml:id="V1.74.0_XSL-libxslt">
  5353. <title>XSL-libxslt</title>
  5354. <para>The following changes have been made to the
  5355. <filename>xsl-libxslt</filename> code
  5356. since the 1.73.2 release.</para>
  5357. <itemizedlist>
  5358. <listitem>
  5359. <para><literal>Mauritz Jeanson: python/xslt.py</literal></para><screen><phrase role="commit-message">Print the result to stdout if no outfile has been given.
  5360. Some unnecessary semicolons removed.</phrase></screen>
  5361. </listitem>
  5362. <listitem>
  5363. <para><literal>Mauritz Jeanson: python/xslt.py</literal></para><screen><phrase role="commit-message">Added a function that quotes parameter values (to ensure that they are interpreted as strings).
  5364. Replaced deprecated functions from the string module with string methods.</phrase></screen>
  5365. </listitem>
  5366. <listitem>
  5367. <para><literal>Michael(tm) Smith: python/README; python/README.LIBXSLT</literal></para><screen><phrase role="commit-message">renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT</phrase></screen>
  5368. </listitem>
  5369. <listitem>
  5370. <para><literal>Mauritz Jeanson: python/README</literal></para><screen><phrase role="commit-message">Tweaked the text a little.</phrase></screen>
  5371. </listitem>
  5372. </itemizedlist>
  5373. </sect2><!--end of XSL-libxslt changes for 1.74.0-->
  5374. </sect1>
  5375. <sect1 xml:id="V1.73.2">
  5376. <title>Release Notes: 1.73.2</title>
  5377. <para>This is solely a minor bug-fix update to the 1.73.1 release.
  5378. It fixes a packaging error in the 1.73.1 package, as well as a
  5379. bug in footnote handling in FO output.</para>
  5380. </sect1>
  5381. <sect1 xml:id="V1.73.1">
  5382. <title>Release: 1.73.1</title>
  5383. <para>This is mostly a bug-fix update to the 1.73.0 release.</para>
  5384. <sect2 xml:id="V1.73.1_Gentext">
  5385. <title>Gentext</title>
  5386. <para>The following changes have been made to the
  5387. <filename>gentext</filename> code
  5388. since the 1.73.0 release.</para>
  5389. <itemizedlist>
  5390. <listitem>
  5391. <para><literal>Mauritz Jeanson: locale/de.xml</literal></para><screen><phrase role="commit-message">Applied patch #1766009.</phrase></screen>
  5392. </listitem>
  5393. <listitem>
  5394. <para><literal>Michael(tm) Smith: locale/lv.xml</literal></para><screen><phrase role="commit-message">Added localization for <tag>ProductionSet</tag>.</phrase></screen>
  5395. </listitem>
  5396. </itemizedlist>
  5397. </sect2><!--end of Gentext changes for 1.73.1-->
  5398. <sect2 xml:id="V1.73.1_FO">
  5399. <title>FO</title>
  5400. <para>The following changes have been made to the
  5401. <filename>fo</filename> code
  5402. since the 1.73.0 release.</para>
  5403. <itemizedlist>
  5404. <listitem>
  5405. <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Modified the <tag>tgroup</tag> template so that, for tables with multiple tgroups,
  5406. a width attribute is output on all corresponding fo:tables. Previously,
  5407. there was a test prohibiting this (and a comment saying that outputting more
  5408. than one width attribute will cause an error). But this seems to be no longer
  5409. relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.</phrase></screen>
  5410. </listitem>
  5411. <listitem>
  5412. <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Replaced useless &lt;a&gt; elements with warning messages (textinsert extension).</phrase></screen>
  5413. </listitem>
  5414. <listitem>
  5415. <para><literal>Mauritz Jeanson: admon.xsl</literal></para><screen><phrase role="commit-message">Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
  5416. references in the <tag>index</tag> can be created. Closes bug #1775086.</phrase></screen>
  5417. </listitem>
  5418. </itemizedlist>
  5419. </sect2><!--end of FO changes for 1.73.1-->
  5420. <sect2 xml:id="V1.73.1_HTML">
  5421. <title>HTML</title>
  5422. <para>The following changes have been made to the
  5423. <filename>html</filename> code
  5424. since the 1.73.0 release.</para>
  5425. <itemizedlist>
  5426. <listitem>
  5427. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:call-template name="process.footnotes"/&gt; to <tag>abstract</tag> template
  5428. so that footnotes in <tag>info</tag>/<tag>abstract</tag> are processed. Closes bug #1760907.</phrase></screen>
  5429. </listitem>
  5430. <listitem>
  5431. <para><literal>Michael(tm) Smith: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Changed handling of HTML output for the <tag>cmdsynopsis</tag> and
  5432. <tag>funcsynopsis</tag> elements, such that a@id instances are generated for
  5433. them if they are descendants of any element containing a dbcmdlist
  5434. or dbfunclist PI. Also, update the embedded <tag>reference</tag> docs for the
  5435. dbcmdlist and dbfunclist PIs to make it clear that they can be
  5436. used within any element for which <tag>cmdsynopsis</tag> or <tag>funcsynopsis</tag> are
  5437. valid children.</phrase></screen>
  5438. </listitem>
  5439. <listitem>
  5440. <para><literal>Michael(tm) Smith: formal.xsl</literal></para><screen><phrase role="commit-message">Reverted the part of <tag>revision</tag> 6952 that caused a@id anchors to be
  5441. generated for output of informal objects. Thanks to Sam Steingold
  5442. for reporting.</phrase></screen>
  5443. </listitem>
  5444. <listitem>
  5445. <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">Account for a <tag>glossary</tag> with no <tag>glossdiv</tag> or <tag>glossentry</tag> children.</phrase></screen>
  5446. </listitem>
  5447. <listitem>
  5448. <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Modified <tag>legalnotice</tag> template so that the base.name parameter is calculated
  5449. in the same way as for <tag>revhistory</tag> chunks. Using &lt;xsl:apply-templates
  5450. mode="chunk-filename" select="."/&gt; did not work for single-page output since
  5451. the template with that mode is in chunk-code.xsl.</phrase></screen>
  5452. </listitem>
  5453. <listitem>
  5454. <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Updated support for SVG (must be a child of <tag>imagedata</tag> in DB 5).
  5455. Added support for MathML in <tag>imagedata</tag>.</phrase></screen>
  5456. </listitem>
  5457. <listitem>
  5458. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added documentation for the dbhh PI (used for context-sensitive HTML Help).
  5459. (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).</phrase></screen>
  5460. </listitem>
  5461. </itemizedlist>
  5462. </sect2><!--end of HTML changes for 1.73.1-->
  5463. <sect2 xml:id="V1.73.1_Manpages">
  5464. <title>Manpages</title>
  5465. <para>The following changes have been made to the
  5466. <filename>manpages</filename> code
  5467. since the 1.73.0 release.</para>
  5468. <itemizedlist>
  5469. <listitem>
  5470. <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, generate warnings about notesources with
  5471. non-para children only if the notesource is a <tag>footnote</tag> or
  5472. <tag>annotation</tag>. Thanks to Sam Steingold for reporting problems with
  5473. the existing handling.</phrase></screen>
  5474. </listitem>
  5475. </itemizedlist>
  5476. </sect2><!--end of Manpages changes for 1.73.1-->
  5477. <sect2 xml:id="V1.73.1_HTMLHelp">
  5478. <title>HTMLHelp</title>
  5479. <para>The following changes have been made to the
  5480. <filename>htmlhelp</filename> code
  5481. since the 1.73.0 release.</para>
  5482. <itemizedlist>
  5483. <listitem>
  5484. <para><literal>Michael(tm) Smith: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
  5485. eclipse, and javahelp stylesheets.</phrase></screen>
  5486. </listitem>
  5487. </itemizedlist>
  5488. </sect2><!--end of HTMLHelp changes for 1.73.1-->
  5489. <sect2 xml:id="V1.73.1_Eclipse">
  5490. <title>Eclipse</title>
  5491. <para>The following changes have been made to the
  5492. <filename>eclipse</filename> code
  5493. since the 1.73.0 release.</para>
  5494. <itemizedlist>
  5495. <listitem>
  5496. <para><literal>Michael(tm) Smith: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
  5497. eclipse, and javahelp stylesheets.</phrase></screen>
  5498. </listitem>
  5499. </itemizedlist>
  5500. </sect2><!--end of Eclipse changes for 1.73.1-->
  5501. <sect2 xml:id="V1.73.1_JavaHelp">
  5502. <title>JavaHelp</title>
  5503. <para>The following changes have been made to the
  5504. <filename>javahelp</filename> code
  5505. since the 1.73.0 release.</para>
  5506. <itemizedlist>
  5507. <listitem>
  5508. <para><literal>Michael(tm) Smith: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
  5509. eclipse, and javahelp stylesheets.</phrase></screen>
  5510. </listitem>
  5511. </itemizedlist>
  5512. </sect2><!--end of JavaHelp changes for 1.73.1-->
  5513. <sect2 xml:id="V1.73.1_Roundtrip">
  5514. <title>Roundtrip</title>
  5515. <para>The following changes have been made to the
  5516. <filename>roundtrip</filename> code
  5517. since the 1.73.0 release.</para>
  5518. <itemizedlist>
  5519. <listitem>
  5520. <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl</literal></para><screen><phrase role="commit-message">Modularised blocks2dbk to allow customisation,
  5521. Added support for tables to pages2normalise</phrase></screen>
  5522. </listitem>
  5523. </itemizedlist>
  5524. </sect2><!--end of Roundtrip changes for 1.73.1-->
  5525. <sect2 xml:id="V1.73.1_Params">
  5526. <title>Params</title>
  5527. <para>The following changes have been made to the
  5528. <filename>params</filename> code
  5529. since the 1.73.0 release.</para>
  5530. <itemizedlist>
  5531. <listitem>
  5532. <para><literal>Robert Stayton: procedure.properties.xml</literal></para><screen><phrase role="commit-message"><tag>procedure</tag> was inheriting keep-together from formal.object.properties, but
  5533. a <tag>procedure</tag> does not need to be kept together by default.</phrase></screen>
  5534. </listitem>
  5535. <listitem>
  5536. <para><literal>Dave Pawson: title.font.family.xml; component.label.includes.part.label.xml; table.frame.b&#x22EF;</literal></para><screen><phrase role="commit-message">Regular formatting re-org.</phrase></screen>
  5537. </listitem>
  5538. </itemizedlist>
  5539. </sect2><!--end of Params changes for 1.73.1-->
  5540. </sect1>
  5541. <sect1 xml:id="V1.73.0">
  5542. <title>Release: 1.73.0</title>
  5543. <para>This release includes important bug fixes and adds the following
  5544. significant feature changes:
  5545. <variablelist>
  5546. <varlistentry>
  5547. <term>New localizations and localization updates</term>
  5548. <listitem>
  5549. <para>We added two new localizations: Latvian and
  5550. Esperanto, and made updates to the Czech, Chinese
  5551. Simplified, Mongolian, Serbian, Italian, and Ukrainian
  5552. localizations.</para>
  5553. </listitem>
  5554. </varlistentry>
  5555. <varlistentry>
  5556. <term>ISO690 citation style for bibliography output.</term>
  5557. <listitem>
  5558. <para>Set the
  5559. <parameter>bibliography.style</parameter> parameter to
  5560. <literal>iso690</literal> to use ISO690 style.</para>
  5561. </listitem>
  5562. </varlistentry>
  5563. <varlistentry>
  5564. <term>New documentation for processing instructions (PI)</term>
  5565. <listitem>
  5566. <para>The reference documentation that ships with the
  5567. release now includes <link xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/pi/">documentation on all PIs</link> that you can use to
  5568. control output from the stylesheets.</para>
  5569. </listitem>
  5570. </varlistentry>
  5571. <varlistentry>
  5572. <term>New profiling parameters for <literal>audience</literal> and <literal>wordsize</literal></term>
  5573. <listitem>
  5574. <para>You can now do profiling based on the values of the
  5575. <literal>audience</literal> and
  5576. <literal>wordsize</literal> attributes.</para>
  5577. </listitem>
  5578. </varlistentry>
  5579. <varlistentry>
  5580. <term>Changes to man-page output</term>
  5581. <listitem>
  5582. <para>The manpages stylesheet now supports single-pass
  5583. profiling and single-pass DocBook 5 namespace stripping
  5584. (just as the HTML and FO stylesheets also do). Also, added
  5585. handling for <tag>mediaobject</tag> &amp;
  5586. <tag>inlinemediaobject</tag>. (Each <tag>imagedata</tag>,
  5587. <tag>audiodata</tag>, or <tag>videodata</tag> element
  5588. within a <tag>mediaobject</tag> or inline
  5589. <tag>mediaobject</tag> is now treated as a "notesource"
  5590. and so handled in much the same way as links and
  5591. <tag>annotation</tag>/<tag>alt</tag>/<tag>footnote</tag>
  5592. are in manpages output.) And added the
  5593. <parameter>man.authors.section.enabled</parameter> and
  5594. <parameter>man.copyright.section.enabled</parameter>
  5595. parameters to enable control over whether output includes
  5596. auto-generated <literal>AUTHORS</literal> and
  5597. <literal>COPYRIGHT</literal> sections.</para>
  5598. </listitem>
  5599. </varlistentry>
  5600. <varlistentry>
  5601. <term>Highlighting support for C</term>
  5602. <listitem>
  5603. <para>The highlighting mechanism for generating
  5604. syntax-highlighted code snippets in output now supports C
  5605. code listings (along with Java, PHP, XSLT, and others).</para>
  5606. </listitem>
  5607. </varlistentry>
  5608. <varlistentry>
  5609. <term>Experimental <literal>docbook-xsl-update script</literal></term>
  5610. <listitem>
  5611. <para>We added an experimental <literal>docbook-xsl-update
  5612. script</literal>, the purpose of which is to facilitate
  5613. easy sync-up to the latest docbook-xsl snapshot (by means
  5614. of rsync).</para>
  5615. </listitem>
  5616. </varlistentry>
  5617. </variablelist>
  5618. </para>
  5619. <sect2 xml:id="V1.73.0_Gentext">
  5620. <title>Gentext</title>
  5621. <para>The following changes have been made to the
  5622. <filename>gentext</filename> code
  5623. since the 1.72.0 release.</para>
  5624. <itemizedlist>
  5625. <listitem>
  5626. <para><literal>Michael(tm) Smith: locale/lv.xml; Makefile</literal></para><screen><phrase role="commit-message">Added Latvian localization file, from Girts Ziemelis.</phrase></screen>
  5627. </listitem>
  5628. <listitem>
  5629. <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Brought up to <tag>date</tag> with en.xml in terms of items. A few strings marked for translation.</phrase></screen>
  5630. </listitem>
  5631. <listitem>
  5632. <para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Added missing translations</phrase></screen>
  5633. </listitem>
  5634. <listitem>
  5635. <para><literal>Robert Stayton: locale/eo.xml</literal></para><screen><phrase role="commit-message">New locale for Esperanto.</phrase></screen>
  5636. </listitem>
  5637. <listitem>
  5638. <para><literal>Robert Stayton: locale/mn.xml</literal></para><screen><phrase role="commit-message">Update from Ganbold Tsagaankhuu.</phrase></screen>
  5639. </listitem>
  5640. <listitem>
  5641. <para><literal>Jirka Kosek: locale/en.xml; locale/cs.xml</literal></para><screen><phrase role="commit-message">Rules for normalizing <tag>glossary</tag> entries before they are sorted can be now different for each language.</phrase></screen>
  5642. </listitem>
  5643. <listitem>
  5644. <para><literal>Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml</literal></para><screen><phrase role="commit-message">Committed changes from Milo&#x161; Komar&#x10D;evi&#x107; to Serbian files.</phrase></screen>
  5645. </listitem>
  5646. <listitem>
  5647. <para><literal>Robert Stayton: locale/ja.xml</literal></para><screen><phrase role="commit-message">Fix <tag>chapter</tag> in context xref-number-and-title</phrase></screen>
  5648. </listitem>
  5649. <listitem>
  5650. <para><literal>Robert Stayton: locale/it.xml</literal></para><screen><phrase role="commit-message">Improved version from contributor.</phrase></screen>
  5651. </listitem>
  5652. <listitem>
  5653. <para><literal>Mauritz Jeanson: locale/uk.xml</literal></para><screen><phrase role="commit-message">Applied patch 1592083.</phrase></screen>
  5654. </listitem>
  5655. </itemizedlist>
  5656. </sect2><!--end of Gentext changes for 1.73.0-->
  5657. <sect2 xml:id="V1.73.0_Common">
  5658. <title>Common</title>
  5659. <para>The following changes have been made to the
  5660. <filename>common</filename> code
  5661. since the 1.72.0 release.</para>
  5662. <itemizedlist>
  5663. <listitem>
  5664. <para><literal>Michael(tm) Smith: labels.xsl</literal></para><screen><phrase role="commit-message">Changed handling of <tag>reference</tag> auto-labeling such that <tag>reference</tag>
  5665. (when it appears at the component level) is now affected by the
  5666. <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
  5667. </listitem>
  5668. <listitem>
  5669. <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
  5670. <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
  5671. </listitem>
  5672. <listitem>
  5673. <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Refined logging output of <tag>refentry</tag> metadata-gathering template;
  5674. for some cases of "missing" elements (<tag>refmiscinfo</tag> stuff, etc.),
  5675. the log messages now include URL to corresponding page in the
  5676. Definitive Guide (TDG).</phrase></screen>
  5677. </listitem>
  5678. <listitem>
  5679. <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add <tag>refsection</tag>/<tag>info</tag>/<tag>title</tag> support.</phrase></screen>
  5680. </listitem>
  5681. <listitem>
  5682. <para><literal>Michael(tm) Smith: titles.xsl</literal></para><screen><phrase role="commit-message">Added support for correct handling of <tag>xref</tag> to elements that
  5683. contain <tag>info</tag>/<tag>title</tag> descendants but no <tag>title</tag> children.
  5684. This should be further refined so that it handles any *<tag>info</tag>
  5685. elements. And there are probably some other places where similar
  5686. handling for *<tag>info</tag>/<tag>title</tag> should be added.</phrase></screen>
  5687. </listitem>
  5688. <listitem>
  5689. <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Modified &lt;xsl:when&gt; in datetime.format template to work
  5690. around Xalan bug.</phrase></screen>
  5691. </listitem>
  5692. </itemizedlist>
  5693. </sect2><!--end of Common changes for 1.73.0-->
  5694. <sect2 xml:id="V1.73.0_FO">
  5695. <title>FO</title>
  5696. <para>The following changes have been made to the
  5697. <filename>fo</filename> code
  5698. since the 1.72.0 release.</para>
  5699. <itemizedlist>
  5700. <listitem>
  5701. <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add parameters to the page.sequence utility template.</phrase></screen>
  5702. </listitem>
  5703. <listitem>
  5704. <para><literal>Mauritz Jeanson: xref.xsl</literal></para><screen><phrase role="commit-message">Added template for <tag>xref</tag> to <tag>area</tag>/<tag>areaset</tag>.
  5705. Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
  5706. </listitem>
  5707. <listitem>
  5708. <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added template match for <tag>person</tag> element to fo stylesheet.</phrase></screen>
  5709. </listitem>
  5710. <listitem>
  5711. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for spacing="compact" in <tag>variablelist</tag>, per bug report #1722540.</phrase></screen>
  5712. </listitem>
  5713. <listitem>
  5714. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message"><tag>table</tag> pgwide="1" should also use pgwide.properties attribute-set.</phrase></screen>
  5715. </listitem>
  5716. <listitem>
  5717. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
  5718. </listitem>
  5719. <listitem>
  5720. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new profiling parameters for audience and wordsize.</phrase></screen>
  5721. </listitem>
  5722. <listitem>
  5723. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added <parameter>callout.icon.size</parameter> parameter.</phrase></screen>
  5724. </listitem>
  5725. <listitem>
  5726. <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink as <tag>olink</tag>.</phrase></screen>
  5727. </listitem>
  5728. <listitem>
  5729. <para><literal>Robert Stayton: autotoc.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add support for <parameter>qanda.in.toc</parameter> to fo <tag>TOC</tag>.</phrase></screen>
  5730. </listitem>
  5731. <listitem>
  5732. <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Improved the page.sequence utility template for use with <tag>book</tag>.</phrase></screen>
  5733. </listitem>
  5734. <listitem>
  5735. <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Refactored the big <tag>book</tag> template into smaller pieces.
  5736. Used the "page.sequence" utility template in
  5737. component.xsl to shorten the <tag>toc</tag> piece.
  5738. Added placeholder templates for front.cover and back.cover.</phrase></screen>
  5739. </listitem>
  5740. <listitem>
  5741. <para><literal>Robert Stayton: param.xweb; param.ent; sections.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>section.container.element</parameter> parameter to enable
  5742. pgwide spans inside sections.</phrase></screen>
  5743. </listitem>
  5744. <listitem>
  5745. <para><literal>Robert Stayton: param.xweb; param.ent; component.xsl</literal></para><screen><phrase role="commit-message">Add component.titlepage.properties attribute-set to
  5746. support span="all" and other properties.</phrase></screen>
  5747. </listitem>
  5748. <listitem>
  5749. <para><literal>Robert Stayton: htmltbl.xsl; table.xsl</literal></para><screen><phrase role="commit-message">Apply table.row.properties template to html <tag>tr</tag> rows too.
  5750. Add keep-with-next to table.row.properties when <tag>row</tag> is in <tag>thead</tag>.</phrase></screen>
  5751. </listitem>
  5752. <listitem>
  5753. <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>default.table.frame</parameter> parameter.
  5754. Fix bug 1575446 rowsep last check for @morerows.</phrase></screen>
  5755. </listitem>
  5756. <listitem>
  5757. <para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>info</tag>/<tag>title</tag> in refsections.</phrase></screen>
  5758. </listitem>
  5759. <listitem>
  5760. <para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Make fo questions and answers behave the same way as html</phrase></screen>
  5761. </listitem>
  5762. <listitem>
  5763. <para><literal>Jirka Kosek: lists.xsl</literal></para><screen><phrase role="commit-message">Added missing attribute set for <tag>procedure</tag></phrase></screen>
  5764. </listitem>
  5765. <listitem>
  5766. <para><literal>Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
  5767. New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
  5768. The code was provided by Jana Dvorakova</phrase></screen>
  5769. </listitem>
  5770. <listitem>
  5771. <para><literal>Robert Stayton: param.xweb; param.ent; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add header.table.properties and footer.table.properties attribute-sets.</phrase></screen>
  5772. </listitem>
  5773. <listitem>
  5774. <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>fop1.extensions</parameter> for <tag>menuchoice</tag> arrow handling exception.</phrase></screen>
  5775. </listitem>
  5776. </itemizedlist>
  5777. </sect2><!--end of FO changes for 1.73.0-->
  5778. <sect2 xml:id="V1.73.0_HTML">
  5779. <title>HTML</title>
  5780. <para>The following changes have been made to the
  5781. <filename>html</filename> code
  5782. since the 1.72.0 release.</para>
  5783. <itemizedlist>
  5784. <listitem>
  5785. <para><literal>Mauritz Jeanson: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Moved declaration and documentation of <parameter>javahelp.encoding</parameter> from javahelp.xsl to the
  5786. regular "parameter machinery".</phrase></screen>
  5787. </listitem>
  5788. <listitem>
  5789. <para><literal>Michael(tm) Smith: admon.xsl</literal></para><screen><phrase role="commit-message">Changed handling of titles for note, warning, <tag>caution</tag>, <tag>important</tag>,
  5790. <tag>tip</tag> admonitions: We now output and HTML h3 head only if
  5791. <parameter>admon.textlabel</parameter> is non-zero or if the admonition actually contains
  5792. a <tag>title</tag>; otherwise, we don't output an h3 head at all.
  5793. (Previously, we were outputting an empty h3 if the <parameter>admon.textlabel</parameter>
  5794. was zero and if the admonition had no title.)</phrase></screen>
  5795. </listitem>
  5796. <listitem>
  5797. <para><literal>Mauritz Jeanson: xref.xsl</literal></para><screen><phrase role="commit-message">Added template for <tag>xref</tag> to <tag>area</tag>/<tag>areaset</tag>.
  5798. Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
  5799. </listitem>
  5800. <listitem>
  5801. <para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl</literal></para><screen><phrase role="commit-message">Added fixes to avoid duplicate ids when <parameter>generate.id.attributes</parameter> = 1.
  5802. This (hopefully) closes bug #1671052.</phrase></screen>
  5803. </listitem>
  5804. <listitem>
  5805. <para><literal>Michael(tm) Smith: formal.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Made the dbfunclist PI work as intended. Also added doc for
  5806. dbfunclist and dbcmdlist PIs.</phrase></screen>
  5807. </listitem>
  5808. <listitem>
  5809. <para><literal>Michael(tm) Smith: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Made the dbcmdlist work the way it appears to have been intended
  5810. to work. Restored dbhtml-dir template back to pi.xsl.</phrase></screen>
  5811. </listitem>
  5812. <listitem>
  5813. <para><literal>Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
  5814. If non-zero, in output of the <tag>abstract</tag> element on titlepages,
  5815. display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
  5816. Because sometimes you really don't want or need that <tag>title</tag>
  5817. there...</phrase></screen>
  5818. </listitem>
  5819. <listitem>
  5820. <para><literal>Michael(tm) Smith: chunk-code.xsl; graphics.xsl</literal></para><screen><phrase role="commit-message">When we are chunking long descriptions for <tag>mediaobject</tag> instances
  5821. into separate HTML output files, and <parameter>use.id.as.filename</parameter> is
  5822. non-zero, if a <tag>mediaobject</tag> has an ID, use that ID as the basename
  5823. for the long-description file (otherwise, we generate an ID for it
  5824. and use that ID as the basename for the file).
  5825. The parallels the recent change made to cause IDs for <tag>legalnotice</tag>
  5826. instances to be used as basenames for <tag>legalnotice</tag> chunks.
  5827. Also, made some minor refinements to the recent changes for
  5828. <tag>legalnotice</tag> chunk handling.</phrase></screen>
  5829. </listitem>
  5830. <listitem>
  5831. <para><literal>Michael(tm) Smith: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
  5832. <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
  5833. </listitem>
  5834. <listitem>
  5835. <para><literal>Michael(tm) Smith: chunk-code.xsl</literal></para><screen><phrase role="commit-message">When $generate.legalnotice.link is non-zero and
  5836. $use.id.as.filename is also non-zero, if a <tag>legalnotice</tag> has an ID,
  5837. then instead of assigning the "ln-&lt;generatedID&gt;" basename to the
  5838. output file for that <tag>legalnotice</tag>, just use its real ID as the
  5839. basename for the file -- as we do when chunking other elements
  5840. that have IDs.</phrase></screen>
  5841. </listitem>
  5842. <listitem>
  5843. <para><literal>David Cramer: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>alt</tag> text on xrefs to steps when the step doesn't have a <tag>title</tag>.</phrase></screen>
  5844. </listitem>
  5845. <listitem>
  5846. <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>term</tag> in <tag>variablelist</tag> when formatted as <tag>table</tag> to avoid misalignment of <tag>term</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
  5847. </listitem>
  5848. <listitem>
  5849. <para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>question</tag> and <tag>answer</tag> labels to avoid misalignment of <tag>label</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
  5850. </listitem>
  5851. <listitem>
  5852. <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around callouts to avoid misalignment of <tag>callout</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
  5853. </listitem>
  5854. <listitem>
  5855. <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
  5856. </listitem>
  5857. <listitem>
  5858. <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add support for new profiling attributes audience and wordsize.</phrase></screen>
  5859. </listitem>
  5860. <listitem>
  5861. <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink olinks.</phrase></screen>
  5862. </listitem>
  5863. <listitem>
  5864. <para><literal>Jirka Kosek: glossary.xsl</literal></para><screen><phrase role="commit-message">Rules for normalizing <tag>glossary</tag> entries before they are sorted can be now different for each language.</phrase></screen>
  5865. </listitem>
  5866. <listitem>
  5867. <para><literal>Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl</literal></para><screen><phrase role="commit-message">Refactored the chunking modules to move all named templates to
  5868. chunk-common.xsl and all match templates to chunk-code.xsl, in
  5869. order to enable better chunk customization.
  5870. See the comments in chunk.xsl for more details.</phrase></screen>
  5871. </listitem>
  5872. <listitem>
  5873. <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add <tag>anchor</tag> for xml:id for <tag>listitem</tag> in <tag>varlistentry</tag>.</phrase></screen>
  5874. </listitem>
  5875. <listitem>
  5876. <para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>info</tag>/<tag>title</tag> in refsections for db5.</phrase></screen>
  5877. </listitem>
  5878. <listitem>
  5879. <para><literal>Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
  5880. New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
  5881. The code was provided by Jana Dvorakova</phrase></screen>
  5882. </listitem>
  5883. <listitem>
  5884. <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add call to class.attribute to &lt;a&gt; output elements so they can
  5885. have a class value too.</phrase></screen>
  5886. </listitem>
  5887. <listitem>
  5888. <para><literal>Mauritz Jeanson: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1644881:
  5889. * Added curly braces around all $language attribute values.
  5890. * Moved declaration of language variable to top level of stylesheet.
  5891. Tested with Xalan, Saxon, and xsltproc.</phrase></screen>
  5892. </listitem>
  5893. </itemizedlist>
  5894. </sect2><!--end of HTML changes for 1.73.0-->
  5895. <sect2 xml:id="V1.73.0_Manpages">
  5896. <title>Manpages</title>
  5897. <para>The following changes have been made to the
  5898. <filename>manpages</filename> code
  5899. since the 1.72.0 release.</para>
  5900. <itemizedlist>
  5901. <listitem>
  5902. <para><literal>Michael(tm) Smith: param.xweb; docbook.xsl; param.ent</literal></para><screen><phrase role="commit-message">Added the <parameter>man.authors.section.enabled</parameter> and
  5903. <parameter>man.copyright.section.enabled</parameter> parameters. Set those to zero when
  5904. you want to suppress display of the auto-generated AUTHORS and
  5905. <tag>COPYRIGHT</tag> sections. Closes request #1467806. Thanks to Daniel
  5906. Leidert.</phrase></screen>
  5907. </listitem>
  5908. <listitem>
  5909. <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Took the test that the manpages stylesheet does to see if there
  5910. are any <tag>Refentry</tag> chilren in current doc, and made it
  5911. namespace-agnostic. Reason for that is because the test otherwise
  5912. won't work when it is copied over into the generated
  5913. profile-docbook.xsl stylesheet.</phrase></screen>
  5914. </listitem>
  5915. <listitem>
  5916. <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added a manpages/profile-docbook.xsl file to enable single-pass
  5917. profiling for manpages output.</phrase></screen>
  5918. </listitem>
  5919. <listitem>
  5920. <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">Output <tag>copyright</tag> and <tag>legalnotice</tag> in man-page output in whatever
  5921. place they are in in document order. Closes #1690539. Thanks to
  5922. Daniel Leidert for reporting.</phrase></screen>
  5923. </listitem>
  5924. <listitem>
  5925. <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Restored support for single-pass namespace stripping to manpages
  5926. stylesheet.</phrase></screen>
  5927. </listitem>
  5928. <listitem>
  5929. <para><literal>Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl; endnotes.xsl; ut&#x22EF;</literal></para><screen><phrase role="commit-message">Changed handling of bold and italic/underline output in manpages
  5930. output. Should be transparent to users, but...
  5931. This touches handling of all bold and italic/underline output. The
  5932. exact change is that the mode="bold" and mode="italic" utility
  5933. templates were changed to named templates. (I think maybe I've
  5934. changed it back and forth from mode to named before, so this is
  5935. maybe re-reverting it yet again).
  5936. Anyway, the reason for the change is that the templates are
  5937. sometimes call on dynamically node-sets, and using modes to format
  5938. those doesn't allow passing <tag>info</tag> about the current/real context
  5939. node from the source (not the node-set created by the stylesheet)
  5940. to that formatting stage.
  5941. The named templates allow the context to be passed in as a
  5942. parameter, so that the bold/ital formatting template can use
  5943. context-aware condition checking.
  5944. This was basically necessary in order to suppress bold formatting
  5945. in titles, which otherwise gets screwed up because of the numbnut
  5946. way that roff handles nested bold/ital.
  5947. Closes #1674534). Much thanks to Daniel Leidert, whose in his
  5948. docbook-xsl bug-finding kung-fu has achieved Grand Master status.</phrase></screen>
  5949. </listitem>
  5950. <listitem>
  5951. <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Fixed handling of example instances by adding the example element
  5952. to the same template we use for processing <tag>figure</tag>. Closes
  5953. #1674538. Thanks to Daniel Leidert.</phrase></screen>
  5954. </listitem>
  5955. <listitem>
  5956. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Don't include lang in manpages <tag>filename</tag>/pathname if lang=en (that
  5957. is, only generate lang-qualified file-/pathnames for non-English).</phrase></screen>
  5958. </listitem>
  5959. <listitem>
  5960. <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, emit warnings for notesources (<tag>footnote</tag>, etc.)
  5961. that have something other than <tag>para</tag> as a child.
  5962. The numbered-with-hanging-indent formatting that's used for
  5963. rendering endnotes in the NOTES <tag>section</tag> of man pages places some
  5964. limits/assumptions on how the DocBook source is marked up; namely,
  5965. for notesources (<tag>footnote</tag>, <tag>annotation</tag>, etc.) that can contain
  5966. block-level children, if the they have a block-level child such as
  5967. a <tag>table</tag> or <tag>itemizedlist</tag> or <tag>orderedlist</tag> that is the first child of
  5968. a <tag>footnote</tag>, we have no way of rendering/indenting its content
  5969. properly in the endnotes list.
  5970. Thus, the manpages stylesheet not emits a warning message for that
  5971. case, and suggests the "fix" (which is to wrap the <tag>table</tag> or
  5972. <tag>itemizedlist</tag> or whatever in a <tag>para</tag> that has some preferatory text.</phrase></screen>
  5973. </listitem>
  5974. <listitem>
  5975. <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added support to mixed-block template for handling tables in
  5976. mixed-blocks (e.g., as child of <tag>para</tag>) correctly.</phrase></screen>
  5977. </listitem>
  5978. <listitem>
  5979. <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl; refentry.xsl; end&#x22EF;</literal></para><screen><phrase role="commit-message">Reverted necessary escaping of backslash, dot, and dash
  5980. out of the well-intentioned (but it now appears,
  5981. misguided) "marker" mechanism (introduced in the 1.72.0
  5982. release) -- which made use of alternative "marker"
  5983. characters as internal representations of those
  5984. characters, and then replaced them just prior to
  5985. serialization -- and back into what's basically the
  5986. system that was used prior to the 1.69.0 release; that
  5987. is, into a part of stylesheet code that gets executed
  5988. at the beginning of processing -- before any other roff
  5989. markup up is. This change obviates the need for the
  5990. marker system. It also requires a lot less RAM during
  5991. processing (for large files, the marker mechanism
  5992. ending up requiring gigabytes of memory).
  5993. Closes bug #1661177. Thanks to Scott Smedley for
  5994. providing a test case (the fvwm man page) that exposed
  5995. the problem with the marker mechanism.
  5996. Also moved the mechanism for converting non-breaking
  5997. spaces back into the same <tag>area</tag> of the stylesheet code.</phrase></screen>
  5998. </listitem>
  5999. <listitem>
  6000. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with incorrect formatting of nested <tag>variablelist</tag>.
  6001. Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.</phrase></screen>
  6002. </listitem>
  6003. <listitem>
  6004. <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Make sure that all listitems in <tag>itemizedlist</tag> and <tag>orderedlist</tag> are
  6005. preceded by a blank line. This fixes a regression that occurred
  6006. when instances of the TP macro that were use in a previous
  6007. versions of the list-handling code were switched to RS/RE (because
  6008. TP doesn't support nesting). TP automatically generates a blank
  6009. line, but RS doesn't. So I added a .sp before each .RS</phrase></screen>
  6010. </listitem>
  6011. <listitem>
  6012. <para><literal>Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl; links.xsl; param.ent</literal></para><screen><phrase role="commit-message">Made a number of changes related to elements with
  6013. out-of-line content:
  6014. - Added handling for <tag>mediaobject</tag> &amp; <tag>inlinemediaobject</tag>.
  6015. Each <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element
  6016. within a <tag>mediaobject</tag> or inline <tag>mediaobject</tag> is now
  6017. treated as a "notesource" and so handled in much the
  6018. same way as links and <tag>annotation</tag>/<tag>alt</tag>/footnotes.
  6019. That means a numbered marker is generated inline to
  6020. mark the place in the main flow where the <tag>imagedata</tag>,
  6021. <tag>audiodata</tag>, or <tag>videodata</tag> element occurs, and a
  6022. corresponding numbered endnote for it is generated in
  6023. the endnotes list at the end of the man page; the
  6024. endnote contains the URL from the fileref attribute
  6025. of the <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element.
  6026. For mediobject and <tag>inlinemediaobject</tag> instances that
  6027. have a <tag>textobject</tag> child, the <tag>textobject</tag> is displayed
  6028. within the main text flow.
  6029. - Renamed several man.link.* params to man.endnotes.*,
  6030. to reflect that fact that the endnotes list now
  6031. contains more than just links. Also did similar
  6032. renaming for a number of stylesheet-internal vars.
  6033. - Added support for xlink:href (along with existing
  6034. support for the legacy ulink element).
  6035. - Cleaned up and streamlined the endnotes-handling
  6036. code. It's still messy and klunky and the basic
  6037. mechanism it uses is very inefficent for documents
  6038. that contain a lot of notesources, but at least it's
  6039. a bit better than it was.</phrase></screen>
  6040. </listitem>
  6041. </itemizedlist>
  6042. </sect2><!--end of Manpages changes for 1.73.0-->
  6043. <sect2 xml:id="V1.73.0_Eclipse">
  6044. <title>Eclipse</title>
  6045. <para>The following changes have been made to the
  6046. <filename>eclipse</filename> code
  6047. since the 1.72.0 release.</para>
  6048. <itemizedlist>
  6049. <listitem>
  6050. <para><literal>Mauritz Jeanson: Makefile</literal></para><screen><phrase role="commit-message">Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.</phrase></screen>
  6051. </listitem>
  6052. <listitem>
  6053. <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. &lt;<tag>title</tag>&gt; Foo&lt;/<tag>title</tag>&gt;) in the source</phrase></screen>
  6054. </listitem>
  6055. </itemizedlist>
  6056. </sect2><!--end of Eclipse changes for 1.73.0-->
  6057. <sect2 xml:id="V1.73.0_JavaHelp">
  6058. <title>JavaHelp</title>
  6059. <para>The following changes have been made to the
  6060. <filename>javahelp</filename> code
  6061. since the 1.72.0 release.</para>
  6062. <itemizedlist>
  6063. <listitem>
  6064. <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Implemented FR #1230233 (sorted <tag>index</tag> in javahelp).</phrase></screen>
  6065. </listitem>
  6066. <listitem>
  6067. <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() around titles and <tag>index</tag> entries to work around whitespace problems.
  6068. Added support for <tag>glossary</tag> and <tag>bibliography</tag> in <tag>toc</tag> and map files.</phrase></screen>
  6069. </listitem>
  6070. </itemizedlist>
  6071. </sect2><!--end of JavaHelp changes for 1.73.0-->
  6072. <sect2 xml:id="V1.73.0_Roundtrip">
  6073. <title>Roundtrip</title>
  6074. <para>The following changes have been made to the
  6075. <filename>roundtrip</filename> code
  6076. since the 1.72.0 release.</para>
  6077. <itemizedlist>
  6078. <listitem>
  6079. <para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl; sections2blocks.&#x22EF;</literal></para><screen><phrase role="commit-message">new stylesheets for better word processor support and easier maintenance</phrase></screen>
  6080. </listitem>
  6081. <listitem>
  6082. <para><literal>Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml</literal></para><screen><phrase role="commit-message">fixed bugs</phrase></screen>
  6083. </listitem>
  6084. </itemizedlist>
  6085. </sect2><!--end of Roundtrip changes for 1.73.0-->
  6086. <sect2 xml:id="V1.73.0_Params">
  6087. <title>Params</title>
  6088. <para>The following changes have been made to the
  6089. <filename>params</filename> code
  6090. since the 1.72.0 release.</para>
  6091. <itemizedlist>
  6092. <listitem>
  6093. <para><literal>Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml; htmlhelp.button.zo&#x22EF;</literal></para><screen><phrase role="commit-message">Modified <tag>refpurpose</tag> text.</phrase></screen>
  6094. </listitem>
  6095. <listitem>
  6096. <para><literal>Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml; htmlhelp.alias.f&#x22EF;</literal></para><screen><phrase role="commit-message">Fixed typos, made some small changes.</phrase></screen>
  6097. </listitem>
  6098. <listitem>
  6099. <para><literal>Mauritz Jeanson: javahelp.encoding.xml</literal></para><screen><phrase role="commit-message">Moved declaration and documentation of <parameter>javahelp.encoding</parameter> from javahelp.xsl to the
  6100. regular "parameter machinery".</phrase></screen>
  6101. </listitem>
  6102. <listitem>
  6103. <para><literal>Mauritz Jeanson: generate.id.attributes.xml</literal></para><screen><phrase role="commit-message">Added <tag>refpurpose</tag> text.</phrase></screen>
  6104. </listitem>
  6105. <listitem>
  6106. <para><literal>Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml; annotation.graphic.close.&#x22EF;</literal></para><screen><phrase role="commit-message">Added better <tag>refpurpose</tag> texts.</phrase></screen>
  6107. </listitem>
  6108. <listitem>
  6109. <para><literal>Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.standalone.xm&#x22EF;</literal></para><screen><phrase role="commit-message">Fixed some broken formatting in source files for chunker.* params,
  6110. as pointed out by Dave Pawson.</phrase></screen>
  6111. </listitem>
  6112. <listitem>
  6113. <para><literal>Michael(tm) Smith: label.from.part.xml</literal></para><screen><phrase role="commit-message">Changed handling of <tag>reference</tag> auto-labeling such that <tag>reference</tag>
  6114. (when it appears at the component level) is now affected by the
  6115. <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
  6116. </listitem>
  6117. <listitem>
  6118. <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarified that 'extension' refers to file names.</phrase></screen>
  6119. </listitem>
  6120. <listitem>
  6121. <para><literal>Michael(tm) Smith: abstract.notitle.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
  6122. If non-zero, in output of the <tag>abstract</tag> element on titlepages,
  6123. display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
  6124. Because sometimes you really don't want or need that <tag>title</tag>
  6125. there...</phrase></screen>
  6126. </listitem>
  6127. <listitem>
  6128. <para><literal>Michael(tm) Smith: man.string.subst.map.xml</literal></para><screen><phrase role="commit-message">Updated manpages string-substitute map to reflect fact that
  6129. because of another recent change to suppress bold markup in .SH
  6130. output, we no longer need to add a workaround for the accidental
  6131. uppercasing of roff escapes that occurred previously.</phrase></screen>
  6132. </listitem>
  6133. <listitem>
  6134. <para><literal>Jirka Kosek: margin.note.float.type.xml; title.font.family.xml; table.frame.border.color.x&#x22EF;</literal></para><screen><phrase role="commit-message">Improved parameter metadata</phrase></screen>
  6135. </listitem>
  6136. <listitem>
  6137. <para><literal>Robert Stayton: profile.wordsize.xml; profile.audience.xml</literal></para><screen><phrase role="commit-message">Add support for profiling on new attributes audience and wordsize.</phrase></screen>
  6138. </listitem>
  6139. <listitem>
  6140. <para><literal>Robert Stayton: callout.graphics.number.limit.xml; callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Added SVG graphics for fo output.</phrase></screen>
  6141. </listitem>
  6142. <listitem>
  6143. <para><literal>Robert Stayton: callout.icon.size.xml</literal></para><screen><phrase role="commit-message">Set size of <tag>callout</tag> graphics.</phrase></screen>
  6144. </listitem>
  6145. <listitem>
  6146. <para><literal>Jirka Kosek: default.units.xml; chunker.output.method.xml; toc.list.type.xml; output.inden&#x22EF;</literal></para><screen><phrase role="commit-message">Updated parameter metadata to the new format.</phrase></screen>
  6147. </listitem>
  6148. <listitem>
  6149. <para><literal>Jirka Kosek: man.output.quietly.xml; title.font.family.xml; footnote.sep.leader.properties&#x22EF;</literal></para><screen><phrase role="commit-message">Added type annotations into parameter definition files.</phrase></screen>
  6150. </listitem>
  6151. <listitem>
  6152. <para><literal>Robert Stayton: section.container.element.xml</literal></para><screen><phrase role="commit-message">Support spans in sections for certain processors.</phrase></screen>
  6153. </listitem>
  6154. <listitem>
  6155. <para><literal>Robert Stayton: component.titlepage.properties.xml</literal></para><screen><phrase role="commit-message">Empty attribute set for top level component titlepage block.
  6156. Allows setting a span on <tag>title</tag> <tag>info</tag>.</phrase></screen>
  6157. </listitem>
  6158. <listitem>
  6159. <para><literal>Jirka Kosek: bibliography.style.xml</literal></para><screen><phrase role="commit-message">Added <tag>link</tag> to WiKi page with description of special markup needed for ISO690 biblioentries</phrase></screen>
  6160. </listitem>
  6161. <listitem>
  6162. <para><literal>Robert Stayton: make.year.ranges.xml</literal></para><screen><phrase role="commit-message">Clarify that multiple <tag>year</tag> elements are required.</phrase></screen>
  6163. </listitem>
  6164. <listitem>
  6165. <para><literal>Robert Stayton: id.warnings.xml</literal></para><screen><phrase role="commit-message">Turn off <parameter>id.warnings</parameter> by default.</phrase></screen>
  6166. </listitem>
  6167. <listitem>
  6168. <para><literal>Jirka Kosek: bibliography.style.xml</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
  6169. New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
  6170. The code was provided by Jana Dvorakova</phrase></screen>
  6171. </listitem>
  6172. <listitem>
  6173. <para><literal>Robert Stayton: header.table.properties.xml; footer.table.properties.xml</literal></para><screen><phrase role="commit-message">Support adding <tag>table</tag> properties to header and footer tables.</phrase></screen>
  6174. </listitem>
  6175. </itemizedlist>
  6176. </sect2><!--end of Params changes for 1.73.0-->
  6177. <sect2 xml:id="V1.73.0_Highlighting">
  6178. <title>Highlighting</title>
  6179. <para>The following changes have been made to the
  6180. <filename>highlighting</filename> code
  6181. since the 1.72.0 release.</para>
  6182. <itemizedlist>
  6183. <listitem>
  6184. <para><literal>Jirka Kosek: c-hl.xml; xslthl-config.xml</literal></para><screen><phrase role="commit-message">Added support for C language. Provided by Bruno Guegan.</phrase></screen>
  6185. </listitem>
  6186. </itemizedlist>
  6187. </sect2><!--end of Highlighting changes for 1.73.0-->
  6188. <sect2 xml:id="V1.73.0_Profiling">
  6189. <title>Profiling</title>
  6190. <para>The following changes have been made to the
  6191. <filename>profiling</filename> code
  6192. since the 1.72.0 release.</para>
  6193. <itemizedlist>
  6194. <listitem>
  6195. <para><literal>Robert Stayton: profile-mode.xsl</literal></para><screen><phrase role="commit-message">Add support for new profiling attributes audience and wordsize.</phrase></screen>
  6196. </listitem>
  6197. </itemizedlist>
  6198. </sect2><!--end of Profiling changes for 1.73.0-->
  6199. <sect2 xml:id="V1.73.0_Lib">
  6200. <title>Lib</title>
  6201. <para>The following changes have been made to the
  6202. <filename>lib</filename> code
  6203. since the 1.72.0 release.</para>
  6204. <itemizedlist>
  6205. <listitem>
  6206. <para><literal>Michael(tm) Smith: lib.xweb</literal></para><screen><phrase role="commit-message">Changed name of prepend-pad template to pad-string and twheeked so
  6207. it can do both right/left padding.</phrase></screen>
  6208. </listitem>
  6209. </itemizedlist>
  6210. </sect2><!--end of Lib changes for 1.73.0-->
  6211. <sect2 xml:id="V1.73.0_Tools">
  6212. <title>Tools</title>
  6213. <para>The following changes have been made to the
  6214. <filename>tools</filename> code
  6215. since the 1.72.0 release.</para>
  6216. <itemizedlist>
  6217. <listitem>
  6218. <para><literal>Michael(tm) Smith: bin; bin/docbook-xsl-update</literal></para><screen><phrase role="commit-message">Did some cleanup to the install.sh source and added a
  6219. docbook-xsl-update script to the docbook-xsl distro, the purpose
  6220. of which is to facilitate easy sync-up to the latest docbook-xsl
  6221. snapshot (by means of rsync).</phrase></screen>
  6222. </listitem>
  6223. </itemizedlist>
  6224. </sect2><!--end of Tools changes for 1.73.0-->
  6225. <sect2 xml:id="V1.73.0_XSL-Saxon">
  6226. <title>XSL-Saxon</title>
  6227. <para>The following changes have been made to the
  6228. <filename>xsl-saxon</filename> code
  6229. since the 1.72.0 release.</para>
  6230. <itemizedlist>
  6231. <listitem>
  6232. <para><literal>Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/&#x22EF;</literal></para><screen><phrase role="commit-message">Added modifications so that the new <parameter>callout.icon.size</parameter> parameter is taken into account. This
  6233. parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
  6234. </listitem>
  6235. <listitem>
  6236. <para><literal>Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x&#x22EF;</literal></para><screen><phrase role="commit-message">Added code for generating id attributes on callouts in HTML and FO output.
  6237. These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
  6238. It works for graphic, unicode and text callouts.
  6239. Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
  6240. </listitem>
  6241. <listitem>
  6242. <para><literal>Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan&#x22EF;</literal></para><screen><phrase role="commit-message">Copied over Website XSL Java extensions.</phrase></screen>
  6243. </listitem>
  6244. </itemizedlist>
  6245. </sect2><!--end of XSL-Saxon changes for 1.73.0-->
  6246. <sect2 xml:id="V1.73.0_XSL-Xalan">
  6247. <title>XSL-Xalan</title>
  6248. <para>The following changes have been made to the
  6249. <filename>xsl-xalan</filename> code
  6250. since the 1.72.0 release.</para>
  6251. <itemizedlist>
  6252. <listitem>
  6253. <para><literal>Michael(tm) Smith: Makefile; xalan2</literal></para><screen><phrase role="commit-message">Turned off xalan2.jar build. This removes DocBook XSL
  6254. Java extensions support for versions of Xalan prior to
  6255. Xalan 2.7. If you are currently using the extensions
  6256. with an earlier version of Xalan, you need to upgrade
  6257. to Xalan 2.7.</phrase></screen>
  6258. </listitem>
  6259. <listitem>
  6260. <para><literal>Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/&#x22EF;</literal></para><screen><phrase role="commit-message">Added modifications so that the new <parameter>callout.icon.size</parameter> parameter is taken into account. This
  6261. parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
  6262. </listitem>
  6263. <listitem>
  6264. <para><literal>Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x&#x22EF;</literal></para><screen><phrase role="commit-message">Added code for generating id attributes on callouts in HTML and FO output.
  6265. These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
  6266. It works for graphic, unicode and text callouts.
  6267. Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
  6268. </listitem>
  6269. <listitem>
  6270. <para><literal>Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan&#x22EF;</literal></para><screen><phrase role="commit-message">Copied over Website XSL Java extensions.</phrase></screen>
  6271. </listitem>
  6272. </itemizedlist>
  6273. </sect2><!--end of XSL-Saxon changes for 1.73.0-->
  6274. </sect1><!--end of changes for the 1.73.0 release-->
  6275. <sect1 xml:id="V1.72.0">
  6276. <title>Release: 1.72.0</title>
  6277. <para>This release includes important bug fixes and adds the following
  6278. significant feature changes:
  6279. <variablelist>
  6280. <varlistentry>
  6281. <term>Automatic sorting of glossary entries</term>
  6282. <listitem>
  6283. <para>The HTML and FO stylesheets now support automatic sorting
  6284. of <tag>glossary</tag> entries. To enable glossary sorting, set
  6285. the value of the <parameter>glossary.sort </parameter> parameter
  6286. to <code>1</code> (by default, it&#x2019;s value is
  6287. <code>0</code>). When you enable glossary sorting,
  6288. <tag>glossentry</tag> elements within a <tag> glossary</tag>,
  6289. <tag>glossdiv</tag>, or <tag>glosslist</tag> are sorted on the
  6290. <tag>glossterm</tag>, using the current language setting. If you
  6291. don&#x2019;t enable glossary sorting, then the order of
  6292. <tag>glossentry</tag> elements is left &#x201C;as is&#x201D; &#x2014; that is, they
  6293. are not sorted but are instead just displayed in document
  6294. order.</para>
  6295. </listitem>
  6296. </varlistentry>
  6297. <varlistentry>
  6298. <term>WordML renamed to Roundtrip, OpenOffice support added</term>
  6299. <listitem>
  6300. <para>Stylesheets for &#x201C;roundtrip&#x201D; conversion between documents in
  6301. OpenOffice format (ODF) and DocBook XML have been added to the set
  6302. of stylesheets that formerly had the collective title
  6303. <wordasword>WordML</wordasword>, and that set of stylesheets has
  6304. been renamed to <wordasword>Roundtrip</wordasword> to better
  6305. reflect the actual scope and purpose of its contents.</para>
  6306. <para>So the DocBook XSL Stylesheets now support roundtrip
  6307. conversion (with certain limitations) of WordML, OpenOffice, and
  6308. Apple Pages documents to and from DocBook XML.</para>
  6309. </listitem>
  6310. </varlistentry>
  6311. <varlistentry>
  6312. <term>Including QandASet questions in TOCs</term>
  6313. <listitem>
  6314. <para>The HTML stylesheet now provides support for including
  6315. <tag>QandASet</tag> <tag>question</tag>s in the document TOC. To
  6316. enable display of <tag>question</tag>s in the document TOC, set
  6317. the value of the <parameter>qanda.in.toc</parameter> to
  6318. <code>1</code> (by default, it&#x2019;s <code>0</code>). When you
  6319. enable <parameter>qanda.in.toc</parameter>, then the generated
  6320. table of contents for a document will include
  6321. <tag>qandaset</tag> titles, <tag>qandadiv</tag> titles, and
  6322. <tag>question</tag> elements. The default value of zero
  6323. excludes them from the TOC.
  6324. <note>
  6325. <para>The <parameter>qanda.in.toc</parameter> parameter does
  6326. not affect any tables of contents that may be generated
  6327. <emphasis>within</emphasis> a <tag>qandaset</tag> or
  6328. <tag>qandadiv</tag> (only in the document TOC).</para>
  6329. </note>
  6330. </para>
  6331. </listitem>
  6332. </varlistentry>
  6333. <varlistentry>
  6334. <term>Language identifier in man-page filenames and pathnames</term>
  6335. <listitem>
  6336. <para>Added new parameter <parameter>man.output.lang.in.name.enabled</parameter>, which controls whether
  6337. a language identifier is included in man-page filenames and
  6338. pathnames. It works like this:</para>
  6339. <para>If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
  6340. man-page files are output with a language identifier included in
  6341. their filenames or pathnames as follows:</para>
  6342. <itemizedlist>
  6343. <listitem><para>if
  6344. <parameter>man.output.subdirs.enabled</parameter> is non-zero,
  6345. each file is output to, e.g., a
  6346. <filename>/$lang/man8/foo.8</filename> pathname</para></listitem>
  6347. <listitem><para>if
  6348. <parameter>man.output.subdirs.enabled</parameter> is zero,
  6349. each file is output with a <tag>foo.$lang.8</tag>
  6350. filename</para></listitem>
  6351. </itemizedlist>
  6352. </listitem>
  6353. </varlistentry>
  6354. <varlistentry>
  6355. <term><parameter>index.page.number.properties</parameter> property set</term>
  6356. <listitem>
  6357. <para>For FO output, use the
  6358. <parameter>index.page.number.properties</parameter> to control
  6359. formatting of page numbers in <tag>index</tag> output &#x2014; to (for
  6360. example) to display page numbers in <tag>index</tag> output in a
  6361. different color (to indicate that they are links).</para>
  6362. </listitem>
  6363. </varlistentry>
  6364. <varlistentry>
  6365. <term>Crop marks in output from Antenna House XSL Formatter</term>
  6366. <listitem>
  6367. <para>Support has been added for generating crop marks in
  6368. print/PDF output generated using Antenna House XSL Formatter</para>
  6369. </listitem>
  6370. </varlistentry>
  6371. <varlistentry>
  6372. <term>More string-substitution hooks in manpages output</term>
  6373. <listitem>
  6374. <para>The <parameter>man.string.subst.map.local.pre</parameter>
  6375. and <parameter>man.string.subst.map.local.post</parameter>
  6376. parameters have been added to enable easier control over
  6377. custom string substitutions.</para>
  6378. </listitem>
  6379. </varlistentry>
  6380. <varlistentry>
  6381. <term>Moved verbatim properties to attribute-set</term>
  6382. <listitem>
  6383. <para>The hardcoded properties used in verbatim elements (literallayout,
  6384. programlisting, screen) were moved to the verbatim.properties
  6385. attribute-set so they can be more easily customized.</para>
  6386. </listitem>
  6387. </varlistentry>
  6388. <varlistentry>
  6389. <term>enhanced simple.xlink template</term>
  6390. <listitem>
  6391. <para>Now the simple.xlink template in inline.xsl works with
  6392. cross reference elements xref and link as well. Also, more elements
  6393. call simple.xlink, which enables DB5 xlink functionality.
  6394. </para>
  6395. </listitem>
  6396. </varlistentry>
  6397. <varlistentry>
  6398. <term>DocBook 5 compatibility</term>
  6399. <listitem>
  6400. <para>Stylesheets now consistently support DocBook 5 attributes
  6401. (such as xml:id). Also, DocBook 5 info elements are now checked
  6402. along with other *info elements, and the use of name() function
  6403. was replaced by local-name() so it also matches on DocBook 5 elements.
  6404. These changes enable reusing the stylesheets with DocBook 5
  6405. documents with minimal fixup.
  6406. </para>
  6407. </listitem>
  6408. </varlistentry>
  6409. <varlistentry>
  6410. <term>HTML class attributes now handled in class.attribute mode </term>
  6411. <listitem>
  6412. <para>The HTML class attributes were formerly hardcoded to the
  6413. element name. Now the class attribute is generated by applying
  6414. templates in class.attribute mode so class attribute names
  6415. can be customized. The default is still the element name.</para>
  6416. </listitem>
  6417. </varlistentry>
  6418. <varlistentry>
  6419. <term>arabic-indic numbering enabled in autolabels</term>
  6420. <listitem>
  6421. <para>Numbering of chapter, sections, and pages can now use
  6422. arabic-indic numbering when number format is set to 'arabicindic' or
  6423. to &#x661;.</para>
  6424. </listitem>
  6425. </varlistentry>
  6426. </variablelist>
  6427. The following is a detailed list of changes (not
  6428. including bug fixes) that have been made since the 1.71.1
  6429. release.</para>
  6430. <sect2 xml:id="V1.72.0_Common">
  6431. <title>Common</title>
  6432. <para>The following changes have been made to the
  6433. <filename>common</filename> code
  6434. since the 1.71.1 release.</para>
  6435. <itemizedlist>
  6436. <listitem>
  6437. <literallayout><phrase role="commit-message">Add support for arabicindic numbering to autolabel.format template.<alt>M: /trunk/xsl/common/labels.xsl - Robert Stayton</alt></phrase></literallayout>
  6438. </listitem>
  6439. <listitem>
  6440. <literallayout><phrase role="commit-message">Finish support for @xml:id everywhere @id is used.<alt>M: /trunk/xsl/common/gentext.xsl; M: /trunk/xsl/common/titles.xsl - Robert Stayton</alt></phrase></literallayout>
  6441. </listitem>
  6442. <listitem>
  6443. <literallayout><phrase role="commit-message">replace name() with local-name() in most cases.<alt>M: /trunk/xsl/common/l10n.xsl; M: /trunk/xsl/common/olink.xsl; M: /trunk/xsl/common/subtitles.xsl; M: /trunk/xsl/common/labels.xsl; M: /trunk/xsl/common/titles.xsl; M: /trunk/xsl/common/common.xsl - Robert Stayton</alt></phrase></literallayout>
  6444. </listitem>
  6445. <listitem>
  6446. <literallayout><phrase role="commit-message">Add support for <tag>info</tag>.<alt>M: /trunk/xsl/common/subtitles.xsl; M: /trunk/xsl/common/labels.xsl; M: /trunk/xsl/common/titles.xsl; M: /trunk/xsl/common/common.xsl; M: /trunk/xsl/common/targets.xsl - Robert Stayton</alt></phrase></literallayout>
  6447. </listitem>
  6448. <listitem>
  6449. <literallayout><phrase role="commit-message">Add utility template tabstyle to return the tabstyle from
  6450. any <tag>table</tag> element.<alt>M: /trunk/xsl/common/table.xsl - Robert Stayton</alt></phrase></literallayout>
  6451. </listitem>
  6452. </itemizedlist>
  6453. </sect2><!--end of Common changes for 1.72.0-->
  6454. <sect2 xml:id="V1.72.0_FO">
  6455. <title>FO</title>
  6456. <para>The following changes have been made to the
  6457. <filename>fo</filename> code
  6458. since the 1.71.1 release.</para>
  6459. <itemizedlist>
  6460. <listitem>
  6461. <literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent; M: /trunk/xsl/fo/glossary.xsl - Robert Stayton</alt></phrase></literallayout>
  6462. </listitem>
  6463. <listitem>
  6464. <literallayout><phrase role="commit-message">Add table.row.properties template to customize <tag>table</tag> rows.<alt>M: /trunk/xsl/fo/table.xsl - Robert Stayton</alt></phrase></literallayout>
  6465. </listitem>
  6466. <listitem>
  6467. <literallayout><phrase role="commit-message">Moved all properties to attribute-sets so can be customized more easily.<alt>M: /trunk/xsl/fo/verbatim.xsl - Robert Stayton</alt></phrase></literallayout>
  6468. </listitem>
  6469. <listitem>
  6470. <literallayout><phrase role="commit-message">Add index.page.number.properties attribute-set to format page numbers.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
  6471. </listitem>
  6472. <listitem>
  6473. <literallayout><phrase role="commit-message"><tag>xref</tag> now supports xlink:href, using simple.xlink template.<alt>M: /trunk/xsl/fo/xref.xsl - Robert Stayton</alt></phrase></literallayout>
  6474. </listitem>
  6475. <listitem>
  6476. <literallayout><phrase role="commit-message">Rewrote simple.xlink, and call it with all charseq templates.<alt>M: /trunk/xsl/fo/inline.xsl - Robert Stayton</alt></phrase></literallayout>
  6477. </listitem>
  6478. <listitem>
  6479. <literallayout><phrase role="commit-message">Add simple.xlink processing to <tag>term</tag> and <tag>member</tag> elements.<alt>M: /trunk/xsl/fo/lists.xsl - Robert Stayton</alt></phrase></literallayout>
  6480. </listitem>
  6481. <listitem>
  6482. <literallayout><phrase role="commit-message">Add support for crop marks in Antenna House.<alt>M: /trunk/xsl/fo/axf.xsl; M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
  6483. </listitem>
  6484. </itemizedlist>
  6485. </sect2><!--end of FO changes for 1.72.0-->
  6486. <sect2 xml:id="V1.72.0_HTML">
  6487. <title>HTML</title>
  6488. <para>The following changes have been made to the
  6489. <filename>html</filename> code
  6490. since the 1.71.1 release.</para>
  6491. <itemizedlist>
  6492. <listitem>
  6493. <literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>M: /trunk/xsl/html/glossary.xsl - Robert Stayton</alt></phrase></literallayout>
  6494. </listitem>
  6495. <listitem>
  6496. <literallayout><phrase role="commit-message">Add support for <parameter>qanda.in.toc</parameter> to add <tag>qandaentry</tag> questions to document <tag>TOC</tag>.<alt>M: /trunk/xsl/html/autotoc.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Robert Stayton</alt></phrase></literallayout>
  6497. </listitem>
  6498. <listitem>
  6499. <literallayout><phrase role="commit-message">add simple.xlink support to <tag>variablelist</tag> <tag>term</tag> and <tag>simplelist</tag> <tag>member</tag>.<alt>M: /trunk/xsl/html/lists.xsl - Robert Stayton</alt></phrase></literallayout>
  6500. </listitem>
  6501. <listitem>
  6502. <literallayout><phrase role="commit-message">*.propagates.style now handled in class.attribute mode.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/block.xsl; M: /trunk/xsl/html/footnote.xsl - Robert Stayton</alt></phrase></literallayout>
  6503. </listitem>
  6504. <listitem>
  6505. <literallayout><phrase role="commit-message">add class parameter to class.attribute mode to set default class.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
  6506. </listitem>
  6507. <listitem>
  6508. <literallayout><phrase role="commit-message">Convert all class attributes to use the class.attribute mode
  6509. so class names can be customized more easily.<alt>M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/chunk-code.xsl; M: /trunk/xsl/html/division.xsl; M: /trunk/xsl/html/sections.xsl; M: /trunk/xsl/html/math.xsl; M: /trunk/xsl/html/block.xsl; M: /trunk/xsl/html/info.xsl; M: /trunk/xsl/html/footnote.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/admon.xsl; M: /trunk/xsl/html/refentry.xsl; M: /trunk/xsl/html/qandaset.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/biblio.xsl; M: /trunk/xsl/html/task.xsl; M: /trunk/xsl/html/component.xsl; M: /trunk/xsl/html/glossary.xsl; M: /trunk/xsl/html/callout.xsl; M: /trunk/xsl/html/index.xsl; M: /trunk/xsl/html/synop.xsl; M: /trunk/xsl/html/verbatim.xsl; M: /trunk/xsl/html/ebnf.xsl - Robert Stayton</alt></phrase></literallayout>
  6510. </listitem>
  6511. <listitem>
  6512. <literallayout><phrase role="commit-message">Add class.attribute mode to generate class attributes.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
  6513. </listitem>
  6514. <listitem>
  6515. <literallayout><phrase role="commit-message">Added simple.xlink to most remaining inlines.
  6516. Changed class attributes to applying class.attributes mode.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
  6517. </listitem>
  6518. <listitem>
  6519. <literallayout><phrase role="commit-message">Changed <tag>xref</tag> template to use simple.xlink tempalte.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
  6520. </listitem>
  6521. <listitem>
  6522. <literallayout><phrase role="commit-message">Improve generate.html.title to work with <tag>link</tag> targets too.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
  6523. </listitem>
  6524. <listitem>
  6525. <literallayout><phrase role="commit-message">Improved simple.xlink to support <tag>link</tag> and <tag>xref</tag>.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
  6526. </listitem>
  6527. <listitem>
  6528. <literallayout><phrase role="commit-message">Use new link.title.attribute now.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
  6529. </listitem>
  6530. <listitem>
  6531. <literallayout><phrase role="commit-message">Rewrote simple.xlink to handle linkend also.
  6532. Better computation of <tag>title</tag> attribute on <tag>link</tag> too.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
  6533. </listitem>
  6534. <listitem>
  6535. <literallayout><phrase role="commit-message">Handle Xalan quirk as special case.<alt>M: /trunk/xsl/html/db5strip.xsl - Robert Stayton</alt></phrase></literallayout>
  6536. </listitem>
  6537. <listitem>
  6538. <literallayout><phrase role="commit-message">Add support for <tag>info</tag>.<alt>M: /trunk/xsl/html/admon.xsl; M: /trunk/xsl/html/autotoc.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/refentry.xsl; M: /trunk/xsl/html/biblio.xsl; M: /trunk/xsl/html/qandaset.xsl; M: /trunk/xsl/html/component.xsl; M: /trunk/xsl/html/glossary.xsl; M: /trunk/xsl/html/division.xsl; M: /trunk/xsl/html/index.xsl; M: /trunk/xsl/html/sections.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/block.xsl - Robert Stayton</alt></phrase></literallayout>
  6539. </listitem>
  6540. <listitem>
  6541. <literallayout><phrase role="commit-message">Fixed imagemaps so they work properly going from calspair coords
  6542. to HTML <tag>area</tag> coords.<alt>M: /trunk/xsl/html/graphics.xsl - Robert Stayton</alt></phrase></literallayout>
  6543. </listitem>
  6544. </itemizedlist>
  6545. </sect2><!--end of HTML changes for 1.72.0-->
  6546. <sect2 xml:id="V1.72.0_Manpages">
  6547. <title>Manpages</title>
  6548. <para>The following changes have been made to the
  6549. <filename>manpages</filename> code
  6550. since the 1.71.1 release.</para>
  6551. <itemizedlist>
  6552. <listitem>
  6553. <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
  6554. checkin completes support for writing file/pathnames for man-pages
  6555. with $lang include in the names. Closes #1585967. knightly
  6556. accolades to Daniel Leidert for providing the feature request.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  6557. </listitem>
  6558. <listitem>
  6559. <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
  6560. controls whether $LANG value is included in manpages
  6561. filenames and pathnames. It works like this:
  6562. If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
  6563. man-page files are output with the $lang value included in
  6564. their filenames or pathnames as follows;
  6565. - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
  6566. output to, e.g., a /$lang/man8/foo.8 pathname
  6567. - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
  6568. with a foo.$lang.8 <tag>filename</tag><alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6569. </listitem>
  6570. <listitem>
  6571. <literallayout><phrase role="commit-message">Use "\e" instead of "\\" for backslash output, because the
  6572. groff docs say that's the correct thing to do; also because
  6573. testing (thanks, Paul Dubois) shows that "\\" doesn't always
  6574. work as expected; for example, "\\" within a <tag>table</tag> seems to
  6575. mess things up.<alt>M: /trunk/xsl/manpages/charmap.groff.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6576. </listitem>
  6577. <listitem>
  6578. <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
  6579. <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
  6580. enable local additions and changes to string-substitution mappings
  6581. without the need to change the value of <parameter>man.string.subst.map</parameter>
  6582. parameter (which is for standard system mappings). Closes
  6583. #1456738. Thanks to Sam Steingold for constructing a true
  6584. stylesheet torture test (the clisp docs) that exposed the need for
  6585. these params.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent; M: /trunk/xsl/manpages/other.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6586. </listitem>
  6587. <listitem>
  6588. <literallayout><phrase role="commit-message">Added the Markup element to the list of elements that get output
  6589. in bold. Thanks to Eric S. Raymond.<alt>M: /trunk/xsl/manpages/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6590. </listitem>
  6591. <listitem>
  6592. <literallayout><phrase role="commit-message">Replaced all dots in roff requests with U+2302 ("house"
  6593. character), and added escaping in output for all instances of dot
  6594. that are not in roff requests. This fixes the problem case where a
  6595. string beginning with a dot (for example, the string ".bashrc")
  6596. might occur at the beginning of a line in output, in which case
  6597. would mistakenly get interpreted as a roff request. Thanks to Eric
  6598. S. Raymond for pushing to fix this.<alt>M: /trunk/xsl/manpages/table.xsl; M: /trunk/xsl/manpages/synop.xsl; M: /trunk/xsl/manpages/block.xsl; M: /trunk/xsl/manpages/info.xsl; M: /trunk/xsl/manpages/lists.xsl; M: /trunk/xsl/manpages/refentry.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6599. </listitem>
  6600. <listitem>
  6601. <literallayout><phrase role="commit-message">Made change to ensure that list content nested in
  6602. <tag>itemizedlist</tag> and <tag>orderedlist</tag> instances is properly indented. This
  6603. is a switch from using .TP to format those lists to using .RS/.RE
  6604. to format them instead (because .TP does not allow nesting). Closes bug #1602616.
  6605. Thanks to Daniel Leidert.<alt>M: /trunk/xsl/manpages/lists.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6606. </listitem>
  6607. </itemizedlist>
  6608. </sect2><!--end of Manpages changes for 1.72.0-->
  6609. <sect2 xml:id="V1.72.0_Params">
  6610. <title>Params</title>
  6611. <para>The following changes have been made to the
  6612. <filename>params</filename> code
  6613. since the 1.71.1 release.</para>
  6614. <itemizedlist>
  6615. <listitem>
  6616. <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
  6617. checkin completes support for writing file/pathnames for man-pages
  6618. with $lang include in the names. Closes #1585967. knightly
  6619. accolades to Daniel Leidert for providing the feature request.<alt>A: /trunk/xsl/params/man.output.lang.in.name.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
  6620. </listitem>
  6621. <listitem>
  6622. <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
  6623. controls whether $LANG value is included in manpages
  6624. filenames and pathnames. It works like this:
  6625. If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
  6626. man-page files are output with the $lang value included in
  6627. their filenames or pathnames as follows;
  6628. - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
  6629. output to, e.g., a /$lang/man8/foo.8 pathname
  6630. - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
  6631. with a foo.$lang.8 <tag>filename</tag><alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6632. </listitem>
  6633. <listitem>
  6634. <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
  6635. <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
  6636. enable local additions and changes to string-substitution mappings
  6637. without the need to change the value of <parameter>man.string.subst.map</parameter>
  6638. parameter (which is for standard system mappings). Closes
  6639. #1456738. Thanks to Sam Steingold for constructing a true
  6640. stylesheet torture test (the clisp docs) that exposed the need for
  6641. these params.<alt>A: /trunk/xsl/params/man.string.subst.map.local.post.xml; A: /trunk/xsl/params/man.string.subst.map.local.pre.xml; M: /trunk/xsl/params/man.string.subst.map.xml - Michael(tm) Smith</alt></phrase></literallayout>
  6642. </listitem>
  6643. <listitem>
  6644. <literallayout><phrase role="commit-message">Add index.page.number.properties by default.<alt>M: /trunk/xsl/params/xep.index.item.properties.xml - Robert Stayton</alt></phrase></literallayout>
  6645. </listitem>
  6646. <listitem>
  6647. <literallayout><phrase role="commit-message">Added <parameter>index.page.number.properties</parameter> to allow customizations of page numbers in indexes.<alt>A: /trunk/xsl/params/index.page.number.properties.xml - Robert Stayton</alt></phrase></literallayout>
  6648. </listitem>
  6649. <listitem>
  6650. <literallayout><phrase role="commit-message">Move show-destination="replace" property from template to attribute-set
  6651. so it can be customized.<alt>M: /trunk/xsl/params/olink.properties.xml - Robert Stayton</alt></phrase></literallayout>
  6652. </listitem>
  6653. <listitem>
  6654. <literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>A: /trunk/xsl/params/glossary.sort.xml - Robert Stayton</alt></phrase></literallayout>
  6655. </listitem>
  6656. <listitem>
  6657. <literallayout><phrase role="commit-message">Add option to include qanda in tables of contents.<alt>A: /trunk/xsl/params/qanda.in.toc.xml - Robert Stayton</alt></phrase></literallayout>
  6658. </listitem>
  6659. <listitem>
  6660. <literallayout><phrase role="commit-message">Moved all properties to attribute-sets so can be customized more easily.<alt>M: /trunk/xsl/params/verbatim.properties.xml - Robert Stayton</alt></phrase></literallayout>
  6661. </listitem>
  6662. </itemizedlist>
  6663. </sect2><!--end of Params changes for 1.72.0-->
  6664. <sect2 xml:id="V1.72.0_Template">
  6665. <title>Template</title>
  6666. <para>The following changes have been made to the
  6667. <filename>template</filename> code
  6668. since the 1.71.1 release.</para>
  6669. <itemizedlist>
  6670. <listitem>
  6671. <literallayout><phrase role="commit-message">Added workaround for Xalan bug: use for-each and copy instead of copy-of (#1604770).<alt>M: /trunk/xsl/template/titlepage.xsl - Mauritz Jeanson</alt></phrase></literallayout>
  6672. </listitem>
  6673. </itemizedlist>
  6674. </sect2><!--end of Template changes for 1.72.0-->
  6675. <sect2 xml:id="V1.72.0_Roundtrip">
  6676. <title>Roundtrip</title>
  6677. <para>The following changes have been made to the
  6678. <filename>roundtrip</filename> code
  6679. since the 1.71.1 release.</para>
  6680. <itemizedlist>
  6681. <listitem>
  6682. <literallayout><phrase role="commit-message">rename to roundtrip, add OpenOffice support<alt>M: /trunk/xsl/roundtrip/docbook-pages.xsl; M: /trunk/xsl/roundtrip/specifications.xml; A: /trunk/xsl/roundtrip/dbk2ooo.xsl; M: /trunk/xsl/roundtrip/docbook.xsl; A: /trunk/xsl/roundtrip/dbk2pages.xsl; M: /trunk/xsl/roundtrip/template.xml; A: /trunk/xsl/roundtrip/dbk2wordml.xsl; A: /trunk/xsl/roundtrip/dbk2wp.xsl; M: /trunk/xsl/roundtrip/template.dot; M: /trunk/xsl/roundtrip/wordml-final.xsl - Steve Ball</alt></phrase></literallayout>
  6683. </listitem>
  6684. </itemizedlist>
  6685. </sect2><!--end of Roundtrip changes for 1.72.0-->
  6686. </sect1><!--end of V1.72.0-->
  6687. <sect1 xml:id="V1.71.1">
  6688. <title>Release: 1.71.1</title>
  6689. <para>This is a minor update to the 1.71.0 release. Along with a
  6690. number of bug fixes, it includes two feature changes:
  6691. <itemizedlist>
  6692. <listitem>
  6693. <para>Added support for profiling based on <tag class="attribute">xml:lang</tag> and <tag class="attribute">status</tag> attributes.</para>
  6694. </listitem>
  6695. <listitem>
  6696. <para>Added initial support in manpages output for
  6697. <tag>footnote</tag>, <tag>annotation</tag>, and <tag>alt</tag>
  6698. instances. Basically, they all now get handled the same way
  6699. <tag>ulink</tag> instances are. They are treated as a class as
  6700. "note sources": A numbered marker is generated at the place in the
  6701. main text flow where they occur, then their contents are displayed
  6702. in an endnotes section at the end of the man page.</para>
  6703. </listitem>
  6704. </itemizedlist>
  6705. </para>
  6706. <sect2 xml:id="V1.71.1_Common">
  6707. <title>Common</title>
  6708. <para>The following changes have been made to the
  6709. <filename>common</filename> code
  6710. since the 1.71.1 release.</para>
  6711. <itemizedlist>
  6712. <listitem>
  6713. <literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>D: /trunk/xsl/common/autoidx-ng.xsl - Jirka Kosek</alt></phrase></literallayout>
  6714. </listitem>
  6715. <listitem>
  6716. <literallayout><phrase role="commit-message">Add support for Xalan generating a root xml:base like saxon.<alt>M: /trunk/xsl/common/stripns.xsl - Robert Stayton</alt></phrase></literallayout>
  6717. </listitem>
  6718. </itemizedlist>
  6719. </sect2><!--end of Common changes for 1.71.1-->
  6720. <sect2 xml:id="V1.71.1_FO">
  6721. <title>FO</title>
  6722. <para>The following changes have been made to the
  6723. <filename>fo</filename> code
  6724. since the 1.71.1 release.</para>
  6725. <itemizedlist>
  6726. <listitem>
  6727. <literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>M: /trunk/xsl/fo/autoidx-ng.xsl; M: /trunk/xsl/fo/autoidx-kosek.xsl - Jirka Kosek</alt></phrase></literallayout>
  6728. </listitem>
  6729. <listitem>
  6730. <literallayout><phrase role="commit-message">Add support for Xalan to add root node xml:base for db5 docs.<alt>M: /trunk/xsl/fo/docbook.xsl - Robert Stayton</alt></phrase></literallayout>
  6731. </listitem>
  6732. <listitem>
  6733. <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Jirka Kosek</alt></phrase></literallayout>
  6734. </listitem>
  6735. </itemizedlist>
  6736. </sect2><!--end of FO changes for 1.71.1-->
  6737. <sect2 xml:id="V1.71.1_HTML">
  6738. <title>HTML</title>
  6739. <para>The following changes have been made to the
  6740. <filename>html</filename> code
  6741. since the 1.71.1 release.</para>
  6742. <itemizedlist>
  6743. <listitem>
  6744. <literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>M: /trunk/xsl/html/autoidx-ng.xsl; M: /trunk/xsl/html/autoidx-kosek.xsl - Jirka Kosek</alt></phrase></literallayout>
  6745. </listitem>
  6746. <listitem>
  6747. <literallayout><phrase role="commit-message">Add support for Xalan to add root node xml:base for db5 docs.<alt>M: /trunk/xsl/html/chunk-code.xsl; M: /trunk/xsl/html/docbook.xsl - Robert Stayton</alt></phrase></literallayout>
  6748. </listitem>
  6749. <listitem>
  6750. <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Jirka Kosek</alt></phrase></literallayout>
  6751. </listitem>
  6752. <listitem>
  6753. <literallayout><phrase role="commit-message">Made changes in namespace declarations to prevent xmllint's
  6754. canonicalizer from treating them as relative namespace URIs.
  6755. - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
  6756. to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";
  6757. Saxon accepts either form
  6758. (see http://www.saxonica.com/documentation/extensibility/functions.html);
  6759. to Saxon, "the part of the URI before the final '/' is immaterial".
  6760. - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
  6761. xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
  6762. either form
  6763. (see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
  6764. just as Saxon does, it will "simply use the string to the
  6765. right of the rightmost forward slash as the Java class name".
  6766. - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
  6767. to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
  6768. adjusted associated code to make the current Xalan redirect spec.
  6769. (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/Redirect.html)<alt>M: /trunk/xsl/html/oldchunker.xsl; M: /trunk/xsl/html/chunker.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/callout.xsl; M: /trunk/xsl/html/autoidx-kimber.xsl; M: /trunk/xsl/html/autoidx-kosek.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/verbatim.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6770. </listitem>
  6771. <listitem>
  6772. <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
  6773. value of both is empty; but the internal DocBook XSL stylesheets
  6774. build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
  6775. to ensure that all files in the docbook-xsl-doc package end in a
  6776. newline character. (Because diff and some other tools may emit
  6777. error messages and/or not behave as expected when processing
  6778. files that are not newline-terminated.)<alt>M: /trunk/xsl/html/chunk-common.xsl; M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/docbook.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  6779. </listitem>
  6780. </itemizedlist>
  6781. </sect2><!--end of HTML changes for 1.71.1-->
  6782. <sect2 xml:id="V1.71.1_Highlighting">
  6783. <title>Highlighting</title>
  6784. <para>The following changes have been made to the
  6785. <filename>highlighting</filename> code
  6786. since the 1.71.1 release.</para>
  6787. <itemizedlist>
  6788. <listitem>
  6789. <literallayout><phrase role="commit-message">Added license information<alt>M: /trunk/xsl/highlighting/delphi-hl.xml; M: /trunk/xsl/highlighting/myxml-hl.xml; M: /trunk/xsl/highlighting/php-hl.xml; M: /trunk/xsl/highlighting/m2-hl.xml; M: /trunk/xsl/highlighting/ini-hl.xml; M: /trunk/xsl/highlighting/xslthl-config.xml; M: /trunk/xsl/highlighting/java-hl.xml - Jirka Kosek</alt></phrase></literallayout>
  6790. </listitem>
  6791. </itemizedlist>
  6792. </sect2><!--end of Highlighting changes for 1.71.1-->
  6793. <sect2 xml:id="V1.71.1_Manpages">
  6794. <title>Manpages</title>
  6795. <para>The following changes have been made to the
  6796. <filename>manpages</filename> code
  6797. since the 1.71.1 release.</para>
  6798. <itemizedlist>
  6799. <listitem>
  6800. <literallayout><phrase role="commit-message">Added initial support in manpages output for <tag>footnote</tag>, <tag>annotation</tag>,
  6801. and <tag>alt</tag> instances. Basically, they all now get handled the same
  6802. way ulink instances are. They are treated as a class as "note
  6803. sources": A numbered marker is generated at the place in the main
  6804. text flow where they occur, then their contents are displayed in
  6805. an endnotes <tag>section</tag> at the end of the man page (currently titled
  6806. REFERENCES, for English output, but will be changed to NOTES).
  6807. This support is not yet complete. It works for most "normal"
  6808. cases, but probably mishandles a good number of cases. More
  6809. testing will be needed to expose the problems. It may well also
  6810. introduce some bugs and regressions in other areas, including
  6811. basic paragraph handling, handling of "mixed block" content,
  6812. handling of other indented content, and handling of authorblurb
  6813. and <tag>personblurb</tag> in the AUTHORS <tag>section</tag>.<alt>M: /trunk/xsl/manpages/table.xsl; M: /trunk/xsl/manpages/block.xsl; M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6814. </listitem>
  6815. </itemizedlist>
  6816. </sect2><!--end of Manpages changes for 1.71.1-->
  6817. <sect2 xml:id="V1.71.1_Params">
  6818. <title>Params</title>
  6819. <para>The following changes have been made to the
  6820. <filename>params</filename> code
  6821. since the 1.71.1 release.</para>
  6822. <itemizedlist>
  6823. <listitem>
  6824. <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>A: /trunk/xsl/params/profile.status.xml - Jirka Kosek</alt></phrase></literallayout>
  6825. </listitem>
  6826. <listitem>
  6827. <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
  6828. value of both is empty; but the internal DocBook XSL stylesheets
  6829. build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
  6830. to ensure that all files in the docbook-xsl-doc <tag>package</tag> end in a
  6831. newline character. (Because diff and some other tools may emit
  6832. error messages and/or not behave as expected when processing
  6833. files that are not newline-terminated.)<alt>A: /trunk/xsl/params/html.append.xml; A: /trunk/xsl/params/chunk.append.xml - Michael(tm) Smith</alt></phrase></literallayout>
  6834. </listitem>
  6835. </itemizedlist>
  6836. </sect2><!--end of Params changes for 1.71.1-->
  6837. <sect2 xml:id="V1.71.1_Profiling">
  6838. <title>Profiling</title>
  6839. <para>The following changes have been made to the
  6840. <filename>profiling</filename> code
  6841. since the 1.71.1 release.</para>
  6842. <itemizedlist>
  6843. <listitem>
  6844. <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/profiling/profile.xsl; M: /trunk/xsl/profiling/profile-mode.xsl - Jirka Kosek</alt></phrase></literallayout>
  6845. </listitem>
  6846. </itemizedlist>
  6847. </sect2><!--end of Profiling changes for 1.71.1-->
  6848. </sect1>
  6849. <sect1 xml:id="V1.71.0">
  6850. <title>Release: 1.71.0</title>
  6851. <para>This is mainly a bug fix release, but it also includes two
  6852. significant feature changes:
  6853. <variablelist>
  6854. <varlistentry>
  6855. <term>Highlighting support added</term>
  6856. <listitem>
  6857. <para>The stylesheets now include support for source-code
  6858. highlighting in output of programlisting instances (controlled
  6859. through the <parameter>highlight.source</parameter>
  6860. parameter). The Java-based implementation requires Saxon and
  6861. makes use of <link xlink:href="http://molhanec.net/"><person><personname><firstname>Michal</firstname><surname>Molhanec</surname></personname></person></link>&#x2019;s <link xlink:href="http://sourceforge.net/projects/xslthl">XSLTHL</link>. More details are available at Jirka Kosek&#x2019;s
  6862. website: <blockquote><simpara><link xlink:href="http://xmlguru.cz/2006/07/docbook-syntax-highlighting"/></simpara></blockquote> The support is currently limited to highlighting
  6863. of XML, Java, PHP, Delphi, Modula-2 sources, and INI
  6864. files.</para>
  6865. </listitem>
  6866. </varlistentry>
  6867. <varlistentry>
  6868. <term>Changes to autoindexing</term>
  6869. <listitem>
  6870. <para>The templates that handle alternative indexing methods
  6871. were reworked to avoid errors produced by certain processors not
  6872. being able to tolerate the presence of unused functions. With
  6873. this release, none of the code for the 'kimber' or 'kosek'
  6874. methods is included in the default stylesheets. In order to use
  6875. one of those methods, your customization layer must import one
  6876. of the optional stylesheet modules:</para>
  6877. <para>
  6878. <itemizedlist>
  6879. <listitem>
  6880. <simpara>html/autoidx-kosek.xsl</simpara>
  6881. </listitem>
  6882. <listitem>
  6883. <simpara>html/autoidx-kimber.xsl</simpara>
  6884. </listitem>
  6885. <listitem>
  6886. <simpara>fo/autoidx-kosek.xsl</simpara>
  6887. </listitem>
  6888. <listitem>
  6889. <simpara>fo/autoidx-kimber.xsl</simpara>
  6890. </listitem>
  6891. </itemizedlist>
  6892. See the <parameter>index.method</parameter> parameter
  6893. reference page for more information.
  6894. </para>
  6895. <para>Two other changes to note:
  6896. <itemizedlist>
  6897. <listitem>
  6898. <simpara>The default indexing method now can handle accented
  6899. characters in latin-based alphabets, not just English. This
  6900. means accented latin letters will group and sort with their
  6901. unaccented counterpart.</simpara>
  6902. </listitem>
  6903. <listitem>
  6904. <simpara>The default value for the
  6905. <parameter>index.method</parameter> parameter was changed
  6906. from 'english' to 'basic' because now the default method can
  6907. handle latin-based alphabets, not just English.</simpara>
  6908. </listitem>
  6909. </itemizedlist>
  6910. </para>
  6911. </listitem>
  6912. </varlistentry>
  6913. </variablelist>
  6914. The following is a list of changes that have
  6915. been made since the 1.70.1 release.</para>
  6916. <sect2 xml:id="V1.71.0_Common">
  6917. <title>Common</title>
  6918. <para>The following changes have been made to the
  6919. <filename>common</filename> code
  6920. since the 1.70.1 release.</para>
  6921. <itemizedlist>
  6922. <listitem>
  6923. <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
  6924. <tag>reference</tag> output.<alt>M: /trunk/xsl/common/labels.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6925. </listitem>
  6926. <listitem>
  6927. <literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/common/table.xsl - Norman Walsh</alt></phrase></literallayout>
  6928. </listitem>
  6929. <listitem>
  6930. <literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/common/autoidx-kimber.xsl; A: /trunk/xsl/common/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
  6931. </listitem>
  6932. <listitem>
  6933. <literallayout><phrase role="commit-message">Support startinglinenumber on <tag>orderedlist</tag><alt>M: /trunk/xsl/common/common.xsl - Norman Walsh</alt></phrase></literallayout>
  6934. </listitem>
  6935. </itemizedlist>
  6936. </sect2><!--end of Common changes for 1.71.0-->
  6937. <sect2 xml:id="V1.71.0_Extensions">
  6938. <title>Extensions</title>
  6939. <para>The following changes have been made to the
  6940. <filename>extensions</filename> code
  6941. since the 1.70.1 release.</para>
  6942. <itemizedlist>
  6943. <listitem>
  6944. <literallayout><phrase role="commit-message">Completely reworked extensions build system; now uses NetBeans and ant<alt>D: /trunk/xsl/extensions/xalan27/.cvsignore; A: /trunk/xsl/extensions/saxon65/nbproject; A: /trunk/xsl/extensions/saxon65/nbproject/project.properties; D: /trunk/xsl/extensions/prj.el; A: /trunk/xsl/extensions/saxon65/src; A: /trunk/xsl/extensions/xalan2/src/com; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Text.java; A: /trunk/xsl/extensions/saxon65/nbproject/project.xml; D: /trunk/xsl/extensions/build.xml; A: /trunk/xsl/extensions/saxon65/build.xml; A: /trunk/xsl/extensions/xalan2/nbproject/genfiles.properties; A: /trunk/xsl/extensions/saxon65; D: /trunk/xsl/extensions/xalan2/com; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Func.java; A: /trunk/xsl/extensions/xalan2/test; A: /trunk/xsl/extensions/saxon65/src/com; A: /trunk/xsl/extensions/xalan2/nbproject/build-impl.xml; A: /trunk/xsl/extensions/xalan2/nbproject; A: /trunk/xsl/extensions/xalan2/src; A: /trunk/xsl/extensions/xalan2/nbproject/project.properties; D: /trunk/xsl/extensions/.cvsignore; M: /trunk/xsl/extensions/Makefile; D: /trunk/xsl/extensions/saxon8; A: /trunk/xsl/extensions/saxon65/nbproject/genfiles.properties; A: /trunk/xsl/extensions/xalan2/nbproject/project.xml; A: /trunk/xsl/extensions/saxon65/test; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Verbatim.java; A: /trunk/xsl/extensions/xalan2/build.xml; M: /trunk/xsl/extensions/xalan2; D: /trunk/xsl/extensions/saxon643; A: /trunk/xsl/extensions/saxon65/nbproject/build-impl.xml - Norman Walsh</alt></phrase></literallayout>
  6945. </listitem>
  6946. </itemizedlist>
  6947. </sect2><!--end of Extensions changes for 1.71.0-->
  6948. <sect2 xml:id="V1.71.0_FO">
  6949. <title>FO</title>
  6950. <para>The following changes have been made to the
  6951. <filename>fo</filename> code
  6952. since the 1.70.1 release.</para>
  6953. <itemizedlist>
  6954. <listitem>
  6955. <literallayout><phrase role="commit-message">xsl:sort lang attribute now uses two-char substring of lang attribute.<alt>M: /trunk/xsl/fo/autoidx-kimber.xsl - Robert Stayton</alt></phrase></literallayout>
  6956. </listitem>
  6957. <listitem>
  6958. <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
  6959. language attribute on <tag>classsynopsis</tag>, etc. (instead of just
  6960. lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
  6961. (instead of just "cpp").
  6962. Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
  6963. to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/fo/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6964. </listitem>
  6965. <listitem>
  6966. <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
  6967. output.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  6968. </listitem>
  6969. <listitem>
  6970. <literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/fo/table.xsl - Norman Walsh</alt></phrase></literallayout>
  6971. </listitem>
  6972. <listitem>
  6973. <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
  6974. and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
  6975. </listitem>
  6976. <listitem>
  6977. <literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/fo/autoidx-kimber.xsl; A: /trunk/xsl/fo/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
  6978. </listitem>
  6979. <listitem>
  6980. <literallayout><phrase role="commit-message">Turn off blank-body for <parameter>fop1.extensions</parameter> too since fop 0.92
  6981. does not support it either.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
  6982. </listitem>
  6983. <listitem>
  6984. <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
  6985. Xalan can use <tag>function</tag> named node-set(), but doesn't
  6986. recognize it using function-available().<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
  6987. </listitem>
  6988. <listitem>
  6989. <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
  6990. where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
  6991. moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
  6992. FO and HTML stylesheets, added support for correctly processing
  6993. <tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/fo/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  6994. </listitem>
  6995. <listitem>
  6996. <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
  6997. <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
  6998. instances, and removed some debugging stuff that was generated in
  6999. manpages output to mark the ends of sections.<alt>M: /trunk/xsl/fo/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7000. </listitem>
  7001. <listitem>
  7002. <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
  7003. default), delimiters are generated around e-mail addresses (output
  7004. of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/fo/inline.xsl; M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  7005. </listitem>
  7006. <listitem>
  7007. <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>M: /trunk/xsl/fo/param.ent; M: /trunk/xsl/fo/param.xweb; A: /trunk/xsl/fo/highlight.xsl; M: /trunk/xsl/fo/verbatim.xsl - Jirka Kosek</alt></phrase></literallayout>
  7008. </listitem>
  7009. <listitem>
  7010. <literallayout><phrase role="commit-message"><tag>Chapter</tag> after <tag>preface</tag> should restart numbering of pages.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Jirka Kosek</alt></phrase></literallayout>
  7011. </listitem>
  7012. </itemizedlist>
  7013. </sect2><!--end of FO changes for 1.71.0-->
  7014. <sect2 xml:id="V1.71.0_HTML">
  7015. <title>HTML</title>
  7016. <para>The following changes have been made to the
  7017. <filename>html</filename> code
  7018. since the 1.70.1 release.</para>
  7019. <itemizedlist>
  7020. <listitem>
  7021. <literallayout><phrase role="commit-message">xsl:sort lang attribute now uses two-char substring of lang attribute.<alt>M: /trunk/xsl/html/autoidx-kimber.xsl - Robert Stayton</alt></phrase></literallayout>
  7022. </listitem>
  7023. <listitem>
  7024. <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
  7025. language attribute on <tag>classsynopsis</tag>, etc. (instead of just
  7026. lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
  7027. (instead of just "cpp").
  7028. Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
  7029. to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/html/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7030. </listitem>
  7031. <listitem>
  7032. <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
  7033. output.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  7034. </listitem>
  7035. <listitem>
  7036. <literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/html/table.xsl - Norman Walsh</alt></phrase></literallayout>
  7037. </listitem>
  7038. <listitem>
  7039. <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
  7040. and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
  7041. </listitem>
  7042. <listitem>
  7043. <literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/html/autoidx-kimber.xsl; A: /trunk/xsl/html/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
  7044. </listitem>
  7045. <listitem>
  7046. <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
  7047. content on HTML <tag>title</tag> pages:
  7048. <parameter>contrib.inline.enabled</parameter>:
  7049. If non-zero (the default), output of the <tag>contrib</tag> element is
  7050. displayed as inline content rather than as block content.
  7051. <parameter>othercredit.like.author.enabled</parameter>:
  7052. If non-zero, output of the <tag>othercredit</tag> element on titlepages is
  7053. displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
  7054. (the default), <tag>othercredit</tag> output is displayed using a style
  7055. different than that of <tag>author</tag> and <tag>editor</tag>.
  7056. <parameter>blurb.on.titlepage.enabled</parameter>:
  7057. If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
  7058. displayed on <tag>title</tag> pages. If zero (the default), output from
  7059. those elements is suppressed on <tag>title</tag> pages (unless you are
  7060. using a titlepage customization that causes them to be included).
  7061. <parameter>editedby.enabled</parameter>
  7062. If non-zero (the default), a localized Edited by heading is
  7063. displayed above <tag>editor</tag> names in output of the <tag>editor</tag> element.<alt>M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  7064. </listitem>
  7065. <listitem>
  7066. <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
  7067. Xalan can use <tag>function</tag> named node-set(), but doesn't
  7068. recognize it using function-available().<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
  7069. </listitem>
  7070. <listitem>
  7071. <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
  7072. where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
  7073. moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
  7074. FO and HTML stylesheets, added support for correctly processing
  7075. <tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7076. </listitem>
  7077. <listitem>
  7078. <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
  7079. <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
  7080. instances, and removed some debugging stuff that was generated in
  7081. manpages output to mark the ends of sections.<alt>M: /trunk/xsl/html/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7082. </listitem>
  7083. <listitem>
  7084. <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
  7085. default), delimiters are generated around e-mail addresses (output
  7086. of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  7087. </listitem>
  7088. <listitem>
  7089. <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
  7090. non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
  7091. of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
  7092. (from Daniel Leidert). Currently on affects HTML output (no patch
  7093. for FO output provided).<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent; M: /trunk/xsl/html/qandaset.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7094. </listitem>
  7095. <listitem>
  7096. <literallayout><phrase role="commit-message">Improved handling of relative locations generated files<alt>M: /trunk/xsl/html/html.xsl - Jirka Kosek</alt></phrase></literallayout>
  7097. </listitem>
  7098. <listitem>
  7099. <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>M: /trunk/xsl/html/param.ent; M: /trunk/xsl/html/param.xweb; A: /trunk/xsl/html/highlight.xsl; M: /trunk/xsl/html/verbatim.xsl - Jirka Kosek</alt></phrase></literallayout>
  7100. </listitem>
  7101. <listitem>
  7102. <literallayout><phrase role="commit-message">Support <tag>org</tag><alt>M: /trunk/xsl/html/info.xsl - Norman Walsh</alt></phrase></literallayout>
  7103. </listitem>
  7104. <listitem>
  7105. <literallayout><phrase role="commit-message">Support <tag>person</tag><alt>M: /trunk/xsl/html/inline.xsl - Norman Walsh</alt></phrase></literallayout>
  7106. </listitem>
  7107. <listitem>
  7108. <literallayout><phrase role="commit-message">Support $keep.relative.image.uris also when chunking<alt>M: /trunk/xsl/html/chunk-code.xsl - Jirka Kosek</alt></phrase></literallayout>
  7109. </listitem>
  7110. </itemizedlist>
  7111. </sect2><!--end of HTML changes for 1.71.0-->
  7112. <sect2 xml:id="V1.71.0_Highlighting">
  7113. <title>Highlighting</title>
  7114. <para>The following changes have been made to the
  7115. <filename>highlighting</filename> code
  7116. since the 1.70.1 release.</para>
  7117. <itemizedlist>
  7118. <listitem>
  7119. <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>A: /trunk/xsl/highlighting/php-hl.xml; A: /trunk/xsl/highlighting/common.xsl; A: /trunk/xsl/highlighting/delphi-hl.xml; A: /trunk/xsl/highlighting/myxml-hl.xml; A: /trunk/xsl/highlighting/m2-hl.xml; A: /trunk/xsl/highlighting/ini-hl.xml; A: /trunk/xsl/highlighting/xslthl-config.xml; A: /trunk/xsl/highlighting/java-hl.xml - Jirka Kosek</alt></phrase></literallayout>
  7120. </listitem>
  7121. </itemizedlist>
  7122. </sect2><!--end of Highlighting changes for 1.71.0-->
  7123. <sect2 xml:id="V1.71.0_Manpages">
  7124. <title>Manpages</title>
  7125. <para>The following changes have been made to the
  7126. <filename>manpages</filename> code
  7127. since the 1.70.1 release.</para>
  7128. <itemizedlist>
  7129. <listitem>
  7130. <literallayout><phrase role="commit-message">Suppress <tag>footnote</tag> markers and output warning that footnotes are
  7131. not yet supported.<alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7132. </listitem>
  7133. <listitem>
  7134. <literallayout><phrase role="commit-message">Handle instances of <tag>address</tag>/<tag>otheraddr</tag>/ulink in <tag>author</tag> et al in the
  7135. same way as <tag>email</tag> instances; that is, display them on the same
  7136. linke as the <tag>author</tag>, <tag>editor</tag>, etc., name.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7137. </listitem>
  7138. <listitem>
  7139. <literallayout><phrase role="commit-message">Don't number or link-list any Ulink instance whose string value is
  7140. identical to the value of its url attribute. Just display it inline.<alt>M: /trunk/xsl/manpages/links.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7141. </listitem>
  7142. <listitem>
  7143. <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
  7144. <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
  7145. instances, and removed some debugging stuff that was generated in
  7146. manpages output to mark the ends of sections.<alt>M: /trunk/xsl/manpages/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7147. </listitem>
  7148. <listitem>
  7149. <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
  7150. default), delimiters are generated around e-mail addresses (output
  7151. of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
  7152. </listitem>
  7153. <listitem>
  7154. <literallayout><phrase role="commit-message">In manpages output, if the last/nearest *<tag>info</tag> element for
  7155. particular <tag>Refentry</tag> has multiple <tag>Copyright</tag> and/or <tag>Legalnotice</tag>
  7156. children, process them all (not just the first ones). Closes bug
  7157. 1524576. Thanks to Sam Steingold for the report and to Daniel
  7158. Leidert for providing a patch.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
  7159. </listitem>
  7160. </itemizedlist>
  7161. </sect2><!--end of Manpages changes for 1.71.0-->
  7162. <sect2 xml:id="V1.71.0_Params">
  7163. <title>Params</title>
  7164. <para>The following changes have been made to the
  7165. <filename>params</filename> code
  7166. since the 1.70.1 release.</para>
  7167. <itemizedlist>
  7168. <listitem>
  7169. <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
  7170. <tag>reference</tag> output.<alt>A: /trunk/xsl/params/reference.autolabel.xml - Michael(tm) Smith</alt></phrase></literallayout>
  7171. </listitem>
  7172. <listitem>
  7173. <literallayout><phrase role="commit-message">Added namespace declarations to document elements for all param files.<alt>M: /trunk/xsl/params/toc.line.properties.xml; M: /trunk/xsl/params/title.font.family.xml; M: /trunk/xsl/params/component.label.includes.part.label.xml; M: /trunk/xsl/params/refentry.manual.profile.xml; M: /trunk/xsl/params/orderedlist.properties.xml; M: /trunk/xsl/params/olink.pubid.xml; M: /trunk/xsl/params/informalexample.properties.xml; M: /trunk/xsl/params/appendix.autolabel.xml; M: /trunk/xsl/params/htmlhelp.show.toolbar.text.xml; M: /trunk/xsl/params/index.on.role.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.url.xml; M: /trunk/xsl/params/variablelist.term.separator.xml; M: /trunk/xsl/params/para.propagates.style.xml; M: /trunk/xsl/params/html.stylesheet.xml; M: /trunk/xsl/params/qanda.nested.in.toc.xml; M: /trunk/xsl/params/annotation.css.xml; M: /trunk/xsl/params/funcsynopsis.style.xml; M: /trunk/xsl/params/htmlhelp.encoding.xml; M: /trunk/xsl/params/footer.content.properties.xml; M: /trunk/xsl/params/verbatim.properties.xml; M: /trunk/xsl/params/autotoc.label.in.hyperlink.xml; M: /trunk/xsl/params/body.margin.top.xml; M: /trunk/xsl/params/bibliography.numbered.xml; M: /trunk/xsl/params/figure.properties.xml; M: /trunk/xsl/params/variablelist.max.termlength.xml; M: /trunk/xsl/params/table.cell.border.style.xml; M: /trunk/xsl/params/htmlhelp.button.options.xml; M: /trunk/xsl/params/preferred.mediaobject.role.xml; M: /trunk/xsl/params/htmlhelp.chm.xml; M: /trunk/xsl/params/man.charmap.subset.profile.xml; M: /trunk/xsl/params/qanda.title.level3.properties.xml; M: /trunk/xsl/params/page.width.xml; M: /trunk/xsl/params/firstterm.only.link.xml; M: /trunk/xsl/params/section.level6.properties.xml; M: /trunk/xsl/params/htmlhelp.button.locate.xml; M: /trunk/xsl/params/chunk.sections.xml; M: /trunk/xsl/params/use.local.olink.style.xml; M: /trunk/xsl/params/refentry.date.profile.enabled.xml; M: /trunk/xsl/params/refentry.version.suppress.xml; M: /trunk/xsl/params/refentry.generate.title.xml; M: /trunk/xsl/params/punct.honorific.xml; M: /trunk/xsl/params/column.gap.index.xml; M: /trunk/xsl/params/body.start.indent.xml; M: /trunk/xsl/params/crop.mark.width.xml; M: /trunk/xsl/params/refentry.version.profile.enabled.xml; M: /trunk/xsl/params/superscript.properties.xml; M: /trunk/xsl/params/chunker.output.doctype-public.xml; M: /trunk/xsl/params/saxon.character.representation.xml; M: /trunk/xsl/params/saxon.linenumbering.xml; M: /trunk/xsl/params/shade.verbatim.style.xml; M: /trunk/xsl/params/annotate.toc.xml; M: /trunk/xsl/params/profile.attribute.xml; M: /trunk/xsl/params/callout.graphics.number.limit.xml; M: /trunk/xsl/params/profile.arch.xml; M: /trunk/xsl/params/saxon.tablecolumns.xml; M: /trunk/xsl/params/glossterm.auto.link.xml; M: /trunk/xsl/params/default.units.xml; M: /trunk/xsl/params/qanda.title.level1.properties.xml; M: /trunk/xsl/params/list.block.spacing.xml; M: /trunk/xsl/params/section.level4.properties.xml; M: /trunk/xsl/params/spacing.paras.xml; M: /trunk/xsl/params/column.count.index.xml; M: /trunk/xsl/params/dingbat.font.family.xml; M: /trunk/xsl/params/citerefentry.link.xml; M: /trunk/xsl/params/keep.relative.image.uris.xml; M: /trunk/xsl/params/ulink.footnotes.xml; M: /trunk/xsl/params/prefer.internal.olink.xml; M: /trunk/xsl/params/refentry.title.properties.xml; M: /trunk/xsl/params/variablelist.term.break.after.xml; M: /trunk/xsl/params/use.id.function.xml; M: /trunk/xsl/params/callout.unicode.start.character.xml; M: /trunk/xsl/params/column.gap.titlepage.xml; M: /trunk/xsl/params/editedby.enabled.xml; M: /trunk/xsl/params/funcsynopsis.tabular.threshold.xml; M: /trunk/xsl/params/use.extensions.xml; M: /trunk/xsl/params/index.preferred.page.properties.xml; M: /trunk/xsl/params/man.th.extra3.max.length.xml; M: /trunk/xsl/params/column.gap.back.xml; M: /trunk/xsl/params/tex.math.delims.xml; M: /trunk/xsl/params/article.appendix.title.properties.xml; M: /trunk/xsl/params/ulink.target.xml; M: /trunk/xsl/params/suppress.header.navigation.xml; M: /trunk/xsl/params/olink.resolver.xml; M: /trunk/xsl/params/admon.textlabel.xml; M: /trunk/xsl/params/procedure.properties.xml; M: /trunk/xsl/params/blurb.on.titlepage.enabled.xml; M: /trunk/xsl/params/section.level2.properties.xml; M: /trunk/xsl/params/column.gap.front.xml; M: /trunk/xsl/params/margin.note.title.properties.xml; M: /trunk/xsl/params/glossary.collection.xml; M: /trunk/xsl/params/admon.graphics.xml; M: /trunk/xsl/params/current.docid.xml; M: /trunk/xsl/params/qanda.inherit.numeration.xml; M: /trunk/xsl/params/table.cell.padding.xml; M: /trunk/xsl/params/preface.autolabel.xml; M: /trunk/xsl/params/man.th.extra3.suppress.xml; M: /trunk/xsl/params/wordml.template.xml; M: /trunk/xsl/params/htmlhelp.use.hhk.xml; M: /trunk/xsl/params/textinsert.extension.xml; M: /trunk/xsl/params/ebnf.table.bgcolor.xml; M: /trunk/xsl/params/refentry.source.fallback.profile.xml; M: /trunk/xsl/params/body.font.master.xml; M: /trunk/xsl/params/l10n.gentext.default.language.xml; M: /trunk/xsl/params/list.block.properties.xml; M: /trunk/xsl/params/refentry.source.name.suppress.xml; M: /trunk/xsl/params/htmlhelp.hhp.window.xml; M: /trunk/xsl/params/sidebar.properties.xml; M: /trunk/xsl/params/tex.math.file.xml; M: /trunk/xsl/params/man.justify.xml; M: /trunk/xsl/params/subscript.properties.xml; M: /trunk/xsl/params/column.count.front.xml; M: /trunk/xsl/params/index.term.separator.xml; M: /trunk/xsl/params/biblioentry.properties.xml; M: /trunk/xsl/params/biblioentry.item.separator.xml; M: /trunk/xsl/params/htmlhelp.button.home.url.xml; M: /trunk/xsl/params/column.count.body.xml; M: /trunk/xsl/params/suppress.navigation.xml; M: /trunk/xsl/params/htmlhelp.remember.window.position.xml; M: /trunk/xsl/params/htmlhelp.hhc.section.depth.xml; M: /trunk/xsl/params/xref.with.number.and.title.xml; M: /trunk/xsl/params/make.year.ranges.xml; M: /trunk/xsl/params/region.before.extent.xml; M: /trunk/xsl/params/xref.label-page.separator.xml; M: /trunk/xsl/params/html.longdesc.link.xml; M: /trunk/xsl/params/man.subheading.divider.enabled.xml; M: /trunk/xsl/params/index.entry.properties.xml; M: /trunk/xsl/params/generate.legalnotice.link.xml; M: /trunk/xsl/params/section.autolabel.xml; M: /trunk/xsl/params/html.base.xml; M: /trunk/xsl/params/suppress.footer.navigation.xml; M: /trunk/xsl/params/nominal.image.depth.xml; M: /trunk/xsl/params/table.footnote.number.symbols.xml; M: /trunk/xsl/params/table.footnote.number.format.xml; M: /trunk/xsl/params/callout.graphics.xml; M: /trunk/xsl/params/man.break.after.slash.xml; M: /trunk/xsl/params/function.parens.xml; M: /trunk/xsl/params/part.autolabel.xml; M: /trunk/xsl/params/saxon.callouts.xml; M: /trunk/xsl/params/css.decoration.xml; M: /trunk/xsl/params/htmlhelp.button.home.xml; M: /trunk/xsl/params/email.delimiters.enabled.xml; M: /trunk/xsl/params/column.count.lot.xml; M: /trunk/xsl/params/draft.mode.xml; M: /trunk/xsl/params/use.role.for.mediaobject.xml; M: /trunk/xsl/params/refentry.separator.xml; M: /trunk/xsl/params/man.font.funcsynopsisinfo.xml; M: /trunk/xsl/params/man.output.manifest.filename.xml; M: /trunk/xsl/params/process.empty.source.toc.xml; M: /trunk/xsl/params/man.output.in.separate.dir.xml; M: /trunk/xsl/params/graphicsize.use.img.src.path.xml; M: /trunk/xsl/params/man.output.encoding.xml; M: /trunk/xsl/params/column.gap.lot.xml; M: /trunk/xsl/params/profile.role.xml; M: /trunk/xsl/params/column.count.titlepage.xml; M: /trunk/xsl/params/show.comments.xml; M: /trunk/xsl/params/informalfigure.properties.xml; M: /trunk/xsl/params/entry.propagates.style.xml; M: /trunk/xsl/params/bibliography.collection.xml; M: /trunk/xsl/params/contrib.inline.enabled.xml; M: /trunk/xsl/params/section.title.level5.properties.xml; M: /trunk/xsl/params/fop.extensions.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.xml; M: /trunk/xsl/params/man.hyphenate.urls.xml; M: /trunk/xsl/params/profile.condition.xml; M: /trunk/xsl/params/header.column.widths.xml; M: /trunk/xsl/params/annotation.js.xml; M: /trunk/xsl/params/chunker.output.standalone.xml; M: /trunk/xsl/params/targets.filename.xml; M: /trunk/xsl/params/default.float.class.xml; M: /trunk/xsl/params/chapter.autolabel.xml; M: /trunk/xsl/params/sidebar.float.type.xml; M: /trunk/xsl/params/profile.separator.xml; M: /trunk/xsl/params/generate.index.xml; M: /trunk/xsl/params/nongraphical.admonition.properties.xml; M: /trunk/xsl/params/navig.graphics.xml; M: /trunk/xsl/params/htmlhelp.button.next.xml; M: /trunk/xsl/params/insert.olink.pdf.frag.xml; M: /trunk/xsl/params/htmlhelp.button.stop.xml; M: /trunk/xsl/params/footnote.font.size.xml; M: /trunk/xsl/params/profile.value.xml; M: /trunk/xsl/params/ebnf.table.border.xml; M: /trunk/xsl/params/htmlhelp.hhc.folders.instead.books.xml; M: /trunk/xsl/params/glossary.as.blocks.xml; M: /trunk/xsl/params/body.end.indent.xml; M: /trunk/xsl/params/use.role.as.xrefstyle.xml; M: /trunk/xsl/params/man.indent.blurbs.xml; M: /trunk/xsl/params/chunker.output.encoding.xml; M: /trunk/xsl/params/chunker.output.omit-xml-declaration.xml; M: /trunk/xsl/params/sans.font.family.xml; M: /trunk/xsl/params/html.cleanup.xml; M: /trunk/xsl/params/htmlhelp.hhp.xml; M: /trunk/xsl/params/htmlhelp.only.xml; M: /trunk/xsl/params/eclipse.plugin.name.xml; M: /trunk/xsl/params/section.title.level3.properties.xml; M: /trunk/xsl/params/man.th.extra1.suppress.xml; M: /trunk/xsl/params/chunk.section.depth.xml; M: /trunk/xsl/params/htmlhelp.hhp.tail.xml; M: /trunk/xsl/params/sidebar.title.properties.xml; M: /trunk/xsl/params/hyphenate.xml; M: /trunk/xsl/params/paper.type.xml; M: /trunk/xsl/params/chunk.tocs.and.lots.has.title.xml; M: /trunk/xsl/params/symbol.font.family.xml; M: /trunk/xsl/params/page.margin.bottom.xml; M: /trunk/xsl/params/callout.unicode.number.limit.xml; M: /trunk/xsl/params/itemizedlist.properties.xml; M: /trunk/xsl/params/root.filename.xml; M: /trunk/xsl/params/tablecolumns.extension.xml; M: /trunk/xsl/params/htmlhelp.show.favorities.xml; M: /trunk/xsl/params/informaltable.properties.xml; M: /trunk/xsl/params/revhistory.table.cell.properties.xml; M: /trunk/xsl/params/htmlhelp.default.topic.xml; M: /trunk/xsl/params/compact.list.item.spacing.xml; M: /trunk/xsl/params/page.height.portrait.xml; M: /trunk/xsl/params/html.head.legalnotice.link.types.xml; M: /trunk/xsl/params/passivetex.extensions.xml; M: /trunk/xsl/params/orderedlist.label.properties.xml; M: /trunk/xsl/params/othercredit.like.author.enabled.xml; M: /trunk/xsl/params/header.content.properties.xml; M: /trunk/xsl/params/refentry.meta.get.quietly.xml; M: /trunk/xsl/params/section.properties.xml; M: /trunk/xsl/params/htmlhelp.button.hideshow.xml; M: /trunk/xsl/params/simplesect.in.toc.xml; M: /trunk/xsl/params/chunk.quietly.xml; M: /trunk/xsl/params/htmlhelp.enumerate.images.xml; M: /trunk/xsl/params/section.title.level1.properties.xml; M: /trunk/xsl/params/qanda.defaultlabel.xml; M: /trunk/xsl/params/htmlhelp.enhanced.decompilation.xml; M: /trunk/xsl/params/man.th.title.max.length.xml; M: /trunk/xsl/params/footnote.number.format.xml; M: /trunk/xsl/params/body.margin.bottom.xml; M: /trunk/xsl/params/htmlhelp.window.geometry.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.xml; M: /trunk/xsl/params/use.svg.xml; M: /trunk/xsl/params/qanda.title.level6.properties.xml; M: /trunk/xsl/params/collect.xref.targets.xml; M: /trunk/xsl/params/html.extra.head.links.xml; M: /trunk/xsl/params/variablelist.as.table.xml; M: /trunk/xsl/params/man.indent.width.xml; M: /trunk/xsl/params/eclipse.plugin.id.xml; M: /trunk/xsl/params/linenumbering.width.xml; M: /trunk/xsl/params/axf.extensions.xml; M: /trunk/xsl/params/menuchoice.separator.xml; M: /trunk/xsl/params/glossterm.separation.xml; M: /trunk/xsl/params/htmlhelp.autolabel.xml; M: /trunk/xsl/params/chunk.separate.lots.xml; M: /trunk/xsl/params/man.hyphenate.computer.inlines.xml; M: /trunk/xsl/params/linenumbering.separator.xml; M: /trunk/xsl/params/htmlhelp.title.xml; M: /trunk/xsl/params/index.number.separator.xml; M: /trunk/xsl/params/htmlhelp.button.prev.xml; M: /trunk/xsl/params/refentry.manual.fallback.profile.xml; M: /trunk/xsl/params/table.frame.border.color.xml; M: /trunk/xsl/params/footnote.sep.leader.properties.xml; M: /trunk/xsl/params/hyphenate.verbatim.characters.xml; M: /trunk/xsl/params/table.cell.border.thickness.xml; M: /trunk/xsl/params/template.xml; M: /trunk/xsl/params/margin.note.properties.xml; M: /trunk/xsl/params/man.segtitle.suppress.xml; M: /trunk/xsl/params/generate.toc.xml; M: /trunk/xsl/params/formal.object.properties.xml; M: /trunk/xsl/params/footnote.mark.properties.xml; M: /trunk/xsl/params/header.table.height.xml; M: /trunk/xsl/params/htmlhelp.button.back.xml; M: /trunk/xsl/params/qanda.title.level4.properties.xml; M: /trunk/xsl/params/man.links.are.numbered.xml; M: /trunk/xsl/params/manual.toc.xml; M: /trunk/xsl/params/olink.lang.fallback.sequence.xml; M: /trunk/xsl/params/refentry.manual.profile.enabled.xml; M: /trunk/xsl/params/ulink.hyphenate.chars.xml; M: /trunk/xsl/params/manifest.xml; M: /trunk/xsl/params/olink.fragid.xml; M: /trunk/xsl/params/refentry.date.profile.xml; M: /trunk/xsl/params/linenumbering.extension.xml; M: /trunk/xsl/params/component.title.properties.xml; M: /trunk/xsl/params/alignment.xml; M: /trunk/xsl/params/refentry.version.profile.xml; M: /trunk/xsl/params/ebnf.assignment.xml; M: /trunk/xsl/params/htmlhelp.button.print.xml; M: /trunk/xsl/params/annotation.support.xml; M: /trunk/xsl/params/sidebar.float.width.xml; M: /trunk/xsl/params/normal.para.spacing.xml; M: /trunk/xsl/params/xref.title-page.separator.xml; M: /trunk/xsl/params/callout.unicode.font.xml; M: /trunk/xsl/params/default.table.frame.xml; M: /trunk/xsl/params/pages.template.xml; M: /trunk/xsl/params/htmlhelp.button.zoom.xml; M: /trunk/xsl/params/admonition.title.properties.xml; M: /trunk/xsl/params/callout.graphics.extension.xml; M: /trunk/xsl/params/make.valid.html.xml; M: /trunk/xsl/params/qanda.title.level2.properties.xml; M: /trunk/xsl/params/page.margin.top.xml; M: /trunk/xsl/params/xep.index.item.properties.xml; M: /trunk/xsl/params/section.level5.properties.xml; M: /trunk/xsl/params/line-height.xml; M: /trunk/xsl/params/table.cell.border.color.xml; M: /trunk/xsl/params/qandadiv.autolabel.xml; M: /trunk/xsl/params/xref.label-title.separator.xml; M: /trunk/xsl/params/chunk.tocs.and.lots.xml; M: /trunk/xsl/params/man.font.funcprototype.xml; M: /trunk/xsl/params/process.source.toc.xml; M: /trunk/xsl/params/page.orientation.xml; M: /trunk/xsl/params/refentry.generate.name.xml; M: /trunk/xsl/params/navig.showtitles.xml; M: /trunk/xsl/params/table.table.properties.xml; M: /trunk/xsl/params/arbortext.extensions.xml; M: /trunk/xsl/params/informalequation.properties.xml; M: /trunk/xsl/params/headers.on.blank.pages.xml; M: /trunk/xsl/params/table.footnote.properties.xml; M: /trunk/xsl/params/root.properties.xml; M: /trunk/xsl/params/htmlhelp.display.progress.xml; M: /trunk/xsl/params/htmlhelp.hhp.windows.xml; M: /trunk/xsl/params/graphical.admonition.properties.xml; M: /trunk/xsl/params/refclass.suppress.xml; M: /trunk/xsl/params/profile.conformance.xml; M: /trunk/xsl/params/htmlhelp.button.forward.xml; M: /trunk/xsl/params/segmentedlist.as.table.xml; M: /trunk/xsl/params/margin.note.float.type.xml; M: /trunk/xsl/params/man.table.footnotes.divider.xml; M: /trunk/xsl/params/man.output.quietly.xml; M: /trunk/xsl/params/htmlhelp.hhc.show.root.xml; M: /trunk/xsl/params/footers.on.blank.pages.xml; M: /trunk/xsl/params/crop.mark.offset.xml; M: /trunk/xsl/params/olink.doctitle.xml; M: /trunk/xsl/params/section.level3.properties.xml; M: /trunk/xsl/params/callout.unicode.xml; M: /trunk/xsl/params/formal.procedures.xml; M: /trunk/xsl/params/toc.section.depth.xml; M: /trunk/xsl/params/index.prefer.titleabbrev.xml; M: /trunk/xsl/params/nominal.image.width.xml; M: /trunk/xsl/params/htmlhelp.show.menu.xml; M: /trunk/xsl/params/linenumbering.everyNth.xml; M: /trunk/xsl/params/double.sided.xml; M: /trunk/xsl/params/generate.revhistory.link.xml; M: /trunk/xsl/params/olink.properties.xml; M: /trunk/xsl/params/tex.math.in.alt.xml; M: /trunk/xsl/params/man.output.subdirs.enabled.xml; M: /trunk/xsl/params/section.title.properties.xml; M: /trunk/xsl/params/column.count.back.xml; M: /trunk/xsl/params/toc.indent.width.xml; M: /trunk/xsl/params/man.charmap.uri.xml; M: /trunk/xsl/params/index.method.xml; M: /trunk/xsl/params/generate.section.toc.level.xml; M: /trunk/xsl/params/page.width.portrait.xml; M: /trunk/xsl/params/man.th.extra2.max.length.xml; M: /trunk/xsl/params/abstract.properties.xml; M: /trunk/xsl/params/revhistory.table.properties.xml; M: /trunk/xsl/params/nominal.table.width.xml; M: /trunk/xsl/params/ulink.show.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.title.xml; M: /trunk/xsl/params/index.div.title.properties.xml; M: /trunk/xsl/params/profile.userlevel.xml; M: /trunk/xsl/params/html.cellpadding.xml; M: /trunk/xsl/params/orderedlist.label.width.xml; M: /trunk/xsl/params/crop.marks.xml; M: /trunk/xsl/params/menuchoice.menu.separator.xml; M: /trunk/xsl/params/author.othername.in.middle.xml; M: /trunk/xsl/params/section.level1.properties.xml; M: /trunk/xsl/params/textdata.default.encoding.xml; M: /trunk/xsl/params/label.from.part.xml; M: /trunk/xsl/params/use.embed.for.svg.xml; M: /trunk/xsl/params/list.item.spacing.xml; M: /trunk/xsl/params/htmlhelp.hhc.width.xml; M: /trunk/xsl/params/column.gap.body.xml; M: /trunk/xsl/params/rootid.xml; M: /trunk/xsl/params/glosslist.as.blocks.xml; M: /trunk/xsl/params/index.range.separator.xml; M: /trunk/xsl/params/html.ext.xml; M: /trunk/xsl/params/callout.list.table.xml; M: /trunk/xsl/params/highlight.source.xml; M: /trunk/xsl/params/show.revisionflag.xml; M: /trunk/xsl/params/man.output.manifest.enabled.xml; M: /trunk/xsl/params/make.single.year.ranges.xml; M: /trunk/xsl/params/pgwide.properties.xml; M: /trunk/xsl/params/generate.id.attributes.xml; M: /trunk/xsl/params/emphasis.propagates.style.xml; M: /trunk/xsl/params/abstract.title.properties.xml; M: /trunk/xsl/params/htmlhelp.hhc.xml; M: /trunk/xsl/params/monospace.properties.xml; M: /trunk/xsl/params/htmlhelp.hhk.xml; M: /trunk/xsl/params/table.borders.with.css.xml; M: /trunk/xsl/params/man.links.are.underlined.xml; M: /trunk/xsl/params/profile.vendor.xml; M: /trunk/xsl/params/shade.verbatim.xml; M: /trunk/xsl/params/callout.graphics.path.xml; M: /trunk/xsl/params/olink.debug.xml; M: /trunk/xsl/params/make.graphic.viewport.xml; M: /trunk/xsl/params/footnote.number.symbols.xml; M: /trunk/xsl/params/man.charmap.enabled.xml; M: /trunk/xsl/params/page.height.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.url.xml; M: /trunk/xsl/params/man.font.table.title.xml; M: /trunk/xsl/params/revhistory.title.properties.xml; M: /trunk/xsl/params/chunker.output.media-type.xml; M: /trunk/xsl/params/glossterm.width.xml; M: /trunk/xsl/params/points.per.em.xml; M: /trunk/xsl/params/page.margin.inner.xml; M: /trunk/xsl/params/itemizedlist.label.width.xml; M: /trunk/xsl/params/ulink.hyphenate.xml; M: /trunk/xsl/params/crop.mark.bleed.xml; M: /trunk/xsl/params/use.id.as.filename.xml; M: /trunk/xsl/params/section.title.level6.properties.xml; M: /trunk/xsl/params/highlight.default.language.xml; M: /trunk/xsl/params/man.th.extra2.suppress.xml; M: /trunk/xsl/params/id.warnings.xml; M: /trunk/xsl/params/title.margin.left.xml; M: /trunk/xsl/params/chunker.output.doctype-system.xml; M: /trunk/xsl/params/man.indent.verbatims.xml; M: /trunk/xsl/params/table.frame.border.thickness.xml; M: /trunk/xsl/params/monospace.verbatim.properties.xml; M: /trunk/xsl/params/formal.title.properties.xml; M: /trunk/xsl/params/margin.note.width.xml; M: /trunk/xsl/params/man.hyphenate.filenames.xml; M: /trunk/xsl/params/blockquote.properties.xml; M: /trunk/xsl/params/callout.defaultcolumn.xml; M: /trunk/xsl/params/profile.security.xml; M: /trunk/xsl/params/informal.object.properties.xml; M: /trunk/xsl/params/formal.title.placement.xml; M: /trunk/xsl/params/draft.watermark.image.xml; M: /trunk/xsl/params/equation.properties.xml; M: /trunk/xsl/params/body.font.family.xml; M: /trunk/xsl/params/ignore.image.scaling.xml; M: /trunk/xsl/params/chunk.first.sections.xml; M: /trunk/xsl/params/base.dir.xml; M: /trunk/xsl/params/footnote.properties.xml; M: /trunk/xsl/params/olink.outline.ext.xml; M: /trunk/xsl/params/img.src.path.xml; M: /trunk/xsl/params/qanda.title.properties.xml; M: /trunk/xsl/params/ebnf.statement.terminator.xml; M: /trunk/xsl/params/callouts.extension.xml; M: /trunk/xsl/params/manifest.in.base.dir.xml; M: /trunk/xsl/params/fop1.extensions.xml; M: /trunk/xsl/params/olink.sysid.xml; M: /trunk/xsl/params/section.title.level4.properties.xml; M: /trunk/xsl/params/monospace.font.family.xml; M: /trunk/xsl/params/l10n.gentext.language.xml; M: /trunk/xsl/params/graphic.default.extension.xml; M: /trunk/xsl/params/default.image.width.xml; M: /trunk/xsl/params/htmlhelp.button.refresh.xml; M: /trunk/xsl/params/chunker.output.cdata-section-elements.xml; M: /trunk/xsl/params/admon.graphics.path.xml; M: /trunk/xsl/params/admon.style.xml; M: /trunk/xsl/params/profile.revision.xml; M: /trunk/xsl/params/generate.manifest.xml; M: /trunk/xsl/params/html.longdesc.xml; M: /trunk/xsl/params/footer.rule.xml; M: /trunk/xsl/params/eclipse.plugin.provider.xml; M: /trunk/xsl/params/refentry.source.name.profile.xml; M: /trunk/xsl/params/toc.max.depth.xml; M: /trunk/xsl/params/chunker.output.indent.xml; M: /trunk/xsl/params/html.head.legalnotice.link.multiple.xml; M: /trunk/xsl/params/toc.list.type.xml; M: /trunk/xsl/params/link.mailto.url.xml; M: /trunk/xsl/params/table.properties.xml; M: /trunk/xsl/params/side.float.properties.xml; M: /trunk/xsl/params/man.charmap.use.subset.xml; M: /trunk/xsl/params/annotation.graphic.open.xml; M: /trunk/xsl/params/html.cellspacing.xml; M: /trunk/xsl/params/default.table.width.xml; M: /trunk/xsl/params/xep.extensions.xml; M: /trunk/xsl/params/admonition.properties.xml; M: /trunk/xsl/params/toc.margin.properties.xml; M: /trunk/xsl/params/chunk.toc.xml; M: /trunk/xsl/params/table.entry.padding.xml; M: /trunk/xsl/params/header.rule.xml; M: /trunk/xsl/params/glossentry.show.acronym.xml; M: /trunk/xsl/params/variablelist.as.blocks.xml; M: /trunk/xsl/params/man.hyphenate.xml; M: /trunk/xsl/params/refentry.source.name.profile.enabled.xml; M: /trunk/xsl/params/section.label.includes.component.label.xml; M: /trunk/xsl/params/bridgehead.in.toc.xml; M: /trunk/xsl/params/section.title.level2.properties.xml; M: /trunk/xsl/params/admon.graphics.extension.xml; M: /trunk/xsl/params/inherit.keywords.xml; M: /trunk/xsl/params/insert.xref.page.number.xml; M: /trunk/xsl/params/pixels.per.inch.xml; M: /trunk/xsl/params/refentry.pagebreak.xml; M: /trunk/xsl/params/profile.lang.xml; M: /trunk/xsl/params/insert.olink.page.number.xml; M: /trunk/xsl/params/generate.meta.abstract.xml; M: /trunk/xsl/params/graphicsize.extension.xml; M: /trunk/xsl/params/man.indent.lists.xml; M: /trunk/xsl/params/funcsynopsis.decoration.xml; M: /trunk/xsl/params/runinhead.title.end.punct.xml; M: /trunk/xsl/params/man.string.subst.map.xml; M: /trunk/xsl/params/man.links.list.enabled.xml; M: /trunk/xsl/params/section.autolabel.max.depth.xml; M: /trunk/xsl/params/htmlhelp.show.advanced.search.xml; M: /trunk/xsl/params/htmlhelp.map.file.xml; M: /trunk/xsl/params/l10n.gentext.use.xref.language.xml; M: /trunk/xsl/params/body.font.size.xml; M: /trunk/xsl/params/html.stylesheet.type.xml; M: /trunk/xsl/params/refentry.xref.manvolnum.xml; M: /trunk/xsl/params/runinhead.default.title.end.punct.xml; M: /trunk/xsl/params/navig.graphics.extension.xml; M: /trunk/xsl/params/itemizedlist.label.properties.xml; M: /trunk/xsl/params/htmlhelp.force.map.and.alias.xml; M: /trunk/xsl/params/profile.os.xml; M: /trunk/xsl/params/htmlhelp.alias.file.xml; M: /trunk/xsl/params/page.margin.outer.xml; M: /trunk/xsl/params/annotation.graphic.close.xml; M: /trunk/xsl/params/eclipse.autolabel.xml; M: /trunk/xsl/params/table.frame.border.style.xml; M: /trunk/xsl/params/navig.graphics.path.xml; M: /trunk/xsl/params/htmlhelp.hhc.binary.xml; M: /trunk/xsl/params/index.on.type.xml; M: /trunk/xsl/params/target.database.document.xml; M: /trunk/xsl/params/man.subheading.divider.xml; M: /trunk/xsl/params/chunker.output.method.xml; M: /trunk/xsl/params/make.index.markup.xml; M: /trunk/xsl/params/olink.base.uri.xml; M: /trunk/xsl/params/phrase.propagates.style.xml; M: /trunk/xsl/params/man.indent.refsect.xml; M: /trunk/xsl/params/example.properties.xml; M: /trunk/xsl/params/man.font.table.headings.xml; M: /trunk/xsl/params/profile.revisionflag.xml; M: /trunk/xsl/params/region.after.extent.xml; M: /trunk/xsl/params/qanda.title.level5.properties.xml; M: /trunk/xsl/params/marker.section.level.xml; M: /trunk/xsl/params/footer.table.height.xml; M: /trunk/xsl/params/autotoc.label.separator.xml; M: /trunk/xsl/params/footer.column.widths.xml; M: /trunk/xsl/params/hyphenate.verbatim.xml; M: /trunk/xsl/params/xref.properties.xml; M: /trunk/xsl/params/man.output.base.dir.xml; M: /trunk/xsl/params/man.links.list.heading.xml; M: /trunk/xsl/params/insert.link.page.number.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.title.xml; M: /trunk/xsl/params/l10n.lang.value.rfc.compliant.xml - Michael(tm) Smith</alt></phrase></literallayout>
  7174. </listitem>
  7175. <listitem>
  7176. <literallayout><phrase role="commit-message">Updated index.method doc to describe revised setup for importing <tag>index</tag> extensions.<alt>M: /trunk/xsl/params/index.method.xml - Robert Stayton</alt></phrase></literallayout>
  7177. </listitem>
  7178. <listitem>
  7179. <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
  7180. content on HTML <tag>title</tag> pages:
  7181. <parameter>contrib.inline.enabled</parameter>:
  7182. If non-zero (the default), output of the <tag>contrib</tag> element is
  7183. displayed as inline content rather than as block content.
  7184. <parameter>othercredit.like.author.enabled</parameter>:
  7185. If non-zero, output of the <tag>othercredit</tag> element on titlepages is
  7186. displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
  7187. (the default), <tag>othercredit</tag> output is displayed using a style
  7188. different than that of <tag>author</tag> and <tag>editor</tag>.
  7189. <parameter>blurb.on.titlepage.enabled</parameter>:
  7190. If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
  7191. displayed on <tag>title</tag> pages. If zero (the default), output from
  7192. those elements is suppressed on <tag>title</tag> pages (unless you are
  7193. using a titlepage customization that causes them to be included).
  7194. <parameter>editedby.enabled</parameter>
  7195. If non-zero (the default), a localized Edited by heading is
  7196. displayed above <tag>editor</tag> names in output of the <tag>editor</tag> element.<alt>A: /trunk/xsl/params/contrib.inline.enabled.xml; A: /trunk/xsl/params/blurb.on.titlepage.enabled.xml; A: /trunk/xsl/params/othercredit.like.author.enabled.xml; A: /trunk/xsl/params/editedby.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
  7197. </listitem>
  7198. <listitem>
  7199. <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
  7200. default), delimiters are generated around e-mail addresses (output
  7201. of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>A: /trunk/xsl/params/email.delimiters.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
  7202. </listitem>
  7203. <listitem>
  7204. <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
  7205. non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
  7206. of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
  7207. (from Daniel Leidert). Currently on affects HTML output (no patch
  7208. for FO output provided).<alt>A: /trunk/xsl/params/qanda.nested.in.toc.xml - Michael(tm) Smith</alt></phrase></literallayout>
  7209. </listitem>
  7210. <listitem>
  7211. <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>A: /trunk/xsl/params/highlight.source.xml; A: /trunk/xsl/params/highlight.default.language.xml - Jirka Kosek</alt></phrase></literallayout>
  7212. </listitem>
  7213. </itemizedlist>
  7214. </sect2><!--end of Params changes for 1.71.0-->
  7215. <sect2 xml:id="V1.71.0_Tools">
  7216. <title>Tools</title>
  7217. <para>The following changes have been made to the
  7218. <filename>tools</filename> code
  7219. since the 1.70.1 release.</para>
  7220. <itemizedlist>
  7221. <listitem>
  7222. <literallayout><phrase role="commit-message">Racheted down font sizes of headings in example makefile FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
  7223. </listitem>
  7224. <listitem>
  7225. <literallayout><phrase role="commit-message">Added param and attribute set to example makefile, for getting
  7226. wrapping in verbatims in FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
  7227. </listitem>
  7228. <listitem>
  7229. <literallayout><phrase role="commit-message">Renamed Makefile.paramDoc to Makefile.docParam.<alt>A: /trunk/xsl/tools/make/Makefile.docParam; D: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
  7230. </listitem>
  7231. <listitem>
  7232. <literallayout><phrase role="commit-message">Added Makefile.paramDoc file, for creating versions of param.xsl
  7233. files with doc embedded.<alt>A: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
  7234. </listitem>
  7235. <listitem>
  7236. <literallayout><phrase role="commit-message">Added variable to example makefile for controlling whether HTML or
  7237. XHTML is generated.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
  7238. </listitem>
  7239. </itemizedlist>
  7240. </sect2><!--end of Tools changes for 1.71.0-->
  7241. </sect1>
  7242. <sect1 xml:id="V1701">
  7243. <title>Release: 1.70.1</title>
  7244. <para>This is a stable release of the 1.70 stylesheets. It includes only a
  7245. few small changes from 1.70.0.</para>
  7246. <para>The following is a list of changes that have been made
  7247. since the 1.70.0 release.</para>
  7248. <sect2 xml:id="V1701_FO">
  7249. <title>FO</title>
  7250. <para>The following changes have been made to the
  7251. <filename>fo</filename> code
  7252. since the 1.70.0 release.</para>
  7253. <itemizedlist>
  7254. <listitem role="commit-message">
  7255. <para>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</para>
  7256. <para role="commit-changes">Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek</para>
  7257. </listitem>
  7258. <listitem role="commit-message">
  7259. <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
  7260. <para role="commit-changes">Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek</para>
  7261. </listitem>
  7262. </itemizedlist>
  7263. </sect2><!--end of FO changes for 1.70.1-->
  7264. <sect2 xml:id="V1701_HTML">
  7265. <title>HTML</title>
  7266. <para>The following changes have been made to the
  7267. <filename>html</filename> code
  7268. since the 1.70.0 release.</para>
  7269. <itemizedlist>
  7270. <listitem role="commit-message">
  7271. <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
  7272. <para role="commit-changes">Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek</para>
  7273. </listitem>
  7274. </itemizedlist>
  7275. </sect2><!--end of HTML changes for 1.70.1-->
  7276. <sect2 xml:id="V1701_HTMLHelp">
  7277. <title>HTMLHelp</title>
  7278. <para>The following changes have been made to the
  7279. <filename>htmlhelp</filename> code
  7280. since the 1.70.0 release.</para>
  7281. <itemizedlist>
  7282. <listitem role="commit-message">
  7283. <para>htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3).</para>
  7284. <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek</para>
  7285. </listitem>
  7286. <listitem role="commit-message">
  7287. <para>Support chunk.tocs.and.lots in HTML Help</para>
  7288. <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek</para>
  7289. </listitem>
  7290. </itemizedlist>
  7291. </sect2><!--end of HTMLHelp changes for 1.70.1-->
  7292. <sect2 xml:id="V1701_Params">
  7293. <title>Params</title>
  7294. <para>The following changes have been made to the
  7295. <filename>params</filename> code
  7296. since the 1.70.0 release.</para>
  7297. <itemizedlist>
  7298. <listitem role="commit-message">
  7299. <para>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</para>
  7300. <para role="commit-changes">Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek</para>
  7301. </listitem>
  7302. </itemizedlist>
  7303. </sect2><!--end of Params changes for 1.70.1-->
  7304. </sect1>
  7305. <sect1 xml:id="V1700">
  7306. <title>Release: 1.70.0</title>
  7307. <para>As with all DocBook Project <link linkend="dot0">dot-zero</link>
  7308. releases, this is an experimental release. It will be followed shortly
  7309. by a stable release.</para>
  7310. <para>This release adds a number of new features,
  7311. including:</para>
  7312. <itemizedlist>
  7313. <listitem>
  7314. <para>support for selecting alternative index-collation methods
  7315. (in particular, support for using a collation library developed by
  7316. Eliot Kimber)</para>
  7317. </listitem>
  7318. <listitem>
  7319. <para>improved handling of DocBook 5 document instances (through a
  7320. namespace-stripping mechanism)</para>
  7321. </listitem>
  7322. <listitem>
  7323. <para>full support for CALS and HTML tables in manpages
  7324. output</para>
  7325. </listitem>
  7326. <listitem>
  7327. <para>a mechanism for preserving relative URIs in documents that
  7328. make use of XInclude</para>
  7329. </listitem>
  7330. <listitem>
  7331. <para>support for the "new" <literal>.90</literal> version of
  7332. FOP</para>
  7333. </listitem>
  7334. <listitem>
  7335. <para>enhanced capabilities for controlling formatting of lists in HTML
  7336. and FO output</para>
  7337. </listitem>
  7338. <listitem>
  7339. <para>autogeneration of AUTHOR and COPYRIGHT sections in manpages
  7340. output</para>
  7341. </listitem>
  7342. <listitem>
  7343. <para>support for generating crop marks in FO/PDF output</para>
  7344. </listitem>
  7345. <listitem>
  7346. <para>support for qandaset as a root element in FO output</para>
  7347. </listitem>
  7348. <listitem>
  7349. <para>support for floatstyle and orient on all table types</para>
  7350. </listitem>
  7351. <listitem>
  7352. <para>support for floatstyle in figure, and example</para>
  7353. </listitem>
  7354. <listitem>
  7355. <para>pgwide.properties attribute-set supports extending figure,
  7356. example and table into the left indent area instead of spanning
  7357. multiple columns.</para>
  7358. </listitem>
  7359. </itemizedlist>
  7360. <para>The following is a detailed list of enhancements and API
  7361. changes that have been made since the 1.69.1 release.</para>
  7362. <sect2 xml:id="V1700_Common">
  7363. <title>Common</title>
  7364. <para>The following changes have been made to the
  7365. <filename>common</filename> code
  7366. since the 1.69.1 release.</para>
  7367. <itemizedlist>
  7368. <listitem role="commit-message">
  7369. <para>Add the xsl:key for the kimber
  7370. indexing method.</para>
  7371. <para role="commit-changes">Modified: common/autoidx-ng.xsl,1.2 - Robert
  7372. Stayton</para>
  7373. </listitem>
  7374. <listitem role="commit-message">
  7375. <para>Add support for
  7376. <tag>qandaset</tag>.</para>
  7377. <para role="commit-changes">Modified: common/labels.xsl,1.37;
  7378. common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert
  7379. Stayton</para>
  7380. </listitem>
  7381. <listitem role="commit-message">
  7382. <para>Support dbhtml/dbfo start PI for
  7383. <tag>orderedlist</tag> numbering in both HTML and
  7384. FO</para>
  7385. <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
  7386. Walsh</para>
  7387. </listitem>
  7388. <listitem role="commit-message">
  7389. <para>Added CVS
  7390. header.</para>
  7391. <para role="commit-changes">Modified: common/stripns.xsl,1.12 - Robert
  7392. Stayton</para>
  7393. </listitem>
  7394. <listitem role="commit-message">
  7395. <para>Changed content model of text
  7396. element to ANY rather than #PCDATA because they could contain
  7397. markup.</para>
  7398. <para role="commit-changes">Modified: common/targetdatabase.dtd,1.7 - Robert
  7399. Stayton</para>
  7400. </listitem>
  7401. <listitem role="commit-message">
  7402. <para>Added
  7403. <tag>refentry</tag>.meta.get.quietly param.</para>
  7404. <para>If zero (the
  7405. default), notes and warnings about "missing" markup are generated
  7406. during gathering of <tag>refentry</tag> metadata. If
  7407. non-zero, the metadata is gathered "quietly" -- that is, the
  7408. notes and warnings are suppressed.</para>
  7409. <para>NOTE: If you are
  7410. processing a large amount of <tag>refentry</tag> content, you
  7411. may be able to speed up processing significantly by setting a
  7412. non-zero value for
  7413. <tag>refentry</tag>.meta.get.quietly.</para>
  7414. <para role="commit-changes">Modified: common/refentry.xsl,1.17;
  7415. manpages/param.ent,1.15; manpages/param.xweb,1.17;
  7416. params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
  7417. Smith</para>
  7418. </listitem>
  7419. <listitem role="commit-message">
  7420. <para>After namespace stripping, the
  7421. source document is the temporary tree created by the stripping
  7422. process and it has the wrong base <tag>URI</tag> for relative
  7423. references. Earlier versions of this code used to try to fix that
  7424. by patching the elements with relative @fileref attributes. That
  7425. was inadequate because it calculated an absolute base <tag>URI</tag>
  7426. without considering that there might be xml:base attributes
  7427. already in effect. It seems obvious now that the right thing to
  7428. do is simply to put the xml:base on the root of the document. And
  7429. that seems to work.</para>
  7430. <para role="commit-changes">Modified: common/stripns.xsl,1.7 - Norman
  7431. Walsh</para>
  7432. </listitem>
  7433. <listitem role="commit-message">
  7434. <para>Added support for "software" and
  7435. "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
  7436. treated identically to "source", and "setdesc" is treated
  7437. identically to "manual".</para>
  7438. <para role="commit-changes">Modified: common/refentry.xsl,1.10;
  7439. params/man.th.extra2.max.length.xml,1.3;
  7440. params/refentry.source.name.profile.xml,1.4 - Michael(tm)
  7441. Smith</para>
  7442. </listitem>
  7443. <listitem role="commit-message">
  7444. <para>Added support for DocBook 5
  7445. namespace-stripping in manpages stylesheet. Closes request
  7446. #1210692.</para>
  7447. <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
  7448. Michael(tm) Smith</para>
  7449. </listitem>
  7450. <listitem role="commit-message">
  7451. <para>Added &lt;xsl:template
  7452. match="/"&gt; to make stripns.xsl usable as a standalone
  7453. stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that
  7454. DocBook XSLT drivers that include this stylesheet all override
  7455. the match="/" template.</para>
  7456. <para role="commit-changes">Modified: common/stripns.xsl,1.4 - Michael(tm)
  7457. Smith</para>
  7458. </listitem>
  7459. <listitem role="commit-message">
  7460. <para>Number figures, examples, and
  7461. tables from <tag>book</tag> if there is no prefix (i.e. if
  7462. <parameter>chapter.autolabel</parameter> is set to 0). This avoids
  7463. having the list of figures where the figures mysteriously restart
  7464. their numeration periodically when
  7465. <parameter>chapter.autolabel</parameter> is set to
  7466. 0.</para>
  7467. <para role="commit-changes">Modified: common/labels.xsl,1.36 - David Cramer</para>
  7468. </listitem>
  7469. <listitem role="commit-message">
  7470. <para>Add <tag>task</tag> template in
  7471. <tag>title</tag>.markup mode.</para>
  7472. <para role="commit-changes">Modified: common/titles.xsl,1.34 - Robert
  7473. Stayton</para>
  7474. </listitem>
  7475. <listitem role="commit-message">
  7476. <para>Add children (with ids) of formal
  7477. objects to target data.</para>
  7478. <para role="commit-changes">Modified: common/targets.xsl,1.10 - Robert
  7479. Stayton</para>
  7480. </listitem>
  7481. <listitem role="commit-message">
  7482. <para>Added support for case when
  7483. <tag>personname</tag> doesn't contain specific name markup (as allowed
  7484. in DocBook 5.0)</para>
  7485. <para role="commit-changes">Modified: common/common.xsl,1.54 - Jirka
  7486. Kosek</para>
  7487. </listitem>
  7488. </itemizedlist>
  7489. </sect2><!--end of Common changes for snapshot_2006-05-15_0803-->
  7490. <sect2 xml:id="V1700_Extensions">
  7491. <title>Extensions</title>
  7492. <para>The following changes have been made to the
  7493. <filename>extensions</filename> code
  7494. since the 1.69.1 release.</para>
  7495. <itemizedlist>
  7496. <listitem role="commit-message">
  7497. <para>Support Xalan
  7498. 2.7</para>
  7499. <para role="commit-changes">Modified: extensions/xalan27/.cvsignore,1.1;
  7500. extensions/xalan27/build.xml,1.1;
  7501. extensions/xalan27/nbproject/.cvsignore,1.1;
  7502. extensions/xalan27/nbproject/build-impl.xml,1.1;
  7503. extensions/xalan27/nbproject/genfiles.properties,1.1;
  7504. extensions/xalan27/nbproject/project.properties,1.1;
  7505. extensions/xalan27/nbproject/project.xml,1.1;
  7506. extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1;
  7507. extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1;
  7508. extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1;
  7509. extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1;
  7510. extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1;
  7511. extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1;
  7512. extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1;
  7513. extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1;
  7514. extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1;
  7515. extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1;
  7516. extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
  7517. extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1;
  7518. extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman
  7519. Walsh</para>
  7520. </listitem>
  7521. <listitem role="commit-message">
  7522. <para>Handle the case where the imageFn
  7523. is actually a <tag>URI</tag>. This still needs
  7524. work.</para>
  7525. <para role="commit-changes">Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4
  7526. - Norman Walsh</para>
  7527. </listitem>
  7528. </itemizedlist>
  7529. </sect2><!--end of Extensions changes for snapshot_2006-05-15_0803-->
  7530. <sect2 xml:id="V1700_FO">
  7531. <title>FO</title>
  7532. <para>The following changes have been made to the
  7533. <filename>fo</filename> code
  7534. since the 1.69.1 release.</para>
  7535. <itemizedlist>
  7536. <listitem role="commit-message">
  7537. <para>Adapted to the new indexing
  7538. code. Now works just like a wrapper that calls kosek indexing method,
  7539. originally implemented here.</para>
  7540. <para role="commit-changes">Modified: fo/autoidx-ng.xsl,1.5 - Jirka
  7541. Kosek</para>
  7542. </listitem>
  7543. <listitem role="commit-message">
  7544. <para>Added parameters for header/footer
  7545. <tag>table</tag> minimum height.</para>
  7546. <para role="commit-changes">Modified: fo/pagesetup.xsl,1.60;
  7547. fo/param.ent,1.100; fo/param.xweb,1.113 - Robert
  7548. Stayton</para>
  7549. </listitem>
  7550. <listitem role="commit-message">
  7551. <para>Add the <tag>index</tag>.method
  7552. parameter.</para>
  7553. <para role="commit-changes">Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert
  7554. Stayton</para>
  7555. </listitem>
  7556. <listitem role="commit-message">
  7557. <para>Integrate support for three
  7558. indexing methods: - the original English-only method. -
  7559. Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
  7560. method using Saxon extensions. Use the '<tag>index</tag>.method'
  7561. parameter to select.</para>
  7562. <para role="commit-changes">Modified: fo/autoidx.xsl,1.38 - Robert
  7563. Stayton</para>
  7564. </listitem>
  7565. <listitem role="commit-message">
  7566. <para>Add support for <tag>TOC</tag> for
  7567. <tag>qandaset</tag> in fo output.</para>
  7568. <para role="commit-changes">Modified: fo/autotoc.xsl,1.30;
  7569. fo/qandaset.xsl,1.20 - Robert Stayton</para>
  7570. </listitem>
  7571. <listitem role="commit-message">
  7572. <para>Added parameter
  7573. <parameter>ulink.hyphenate</parameter>.chars. Added parameter
  7574. insert.<tag>link</tag>.page.number.</para>
  7575. <para role="commit-changes">Modified: fo/param.ent,1.98;
  7576. fo/param.xweb,1.111 - Robert Stayton</para>
  7577. </listitem>
  7578. <listitem role="commit-message">
  7579. <para>Implemented feature request
  7580. #942524 to add insert.<tag>link</tag>.page.number to allow link
  7581. element cross references to have a page number.</para>
  7582. <para role="commit-changes">Modified: fo/xref.xsl,1.67 -
  7583. Robert Stayton</para>
  7584. </listitem>
  7585. <listitem role="commit-message">
  7586. <para>Add support for
  7587. <parameter>ulink.hyphenate</parameter>.chars so more characters
  7588. can be break points in urls.</para>
  7589. <para role="commit-changes">Modified: fo/xref.xsl,1.66 - Robert
  7590. Stayton</para>
  7591. </listitem>
  7592. <listitem role="commit-message">
  7593. <para>Implemented patch #1075144 to make
  7594. the url text in a ulink in FO output an active <tag>link</tag> as
  7595. well.</para>
  7596. <para role="commit-changes">Modified: fo/xref.xsl,1.65 - Robert Stayton</para>
  7597. </listitem>
  7598. <listitem role="commit-message">
  7599. <para><tag>table</tag> footnotes now
  7600. have their own <tag>table</tag>.<tag>footnote</tag>.properties
  7601. attribute set.</para>
  7602. <para role="commit-changes">Modified: fo/footnote.xsl,1.23 - Robert
  7603. Stayton</para>
  7604. </listitem>
  7605. <listitem role="commit-message">
  7606. <para>Add <tag>qandaset</tag> to
  7607. root.elements.</para>
  7608. <para role="commit-changes">Modified: fo/docbook.xsl,1.41 - Robert
  7609. Stayton</para>
  7610. </listitem>
  7611. <listitem role="commit-message">
  7612. <para>Added mode="page.sequence" to make
  7613. it easier to put content into a page sequence. First used for
  7614. <tag>qandaset</tag>.</para>
  7615. <para role="commit-changes">Modified: fo/component.xsl,1.37 - Robert
  7616. Stayton</para>
  7617. </listitem>
  7618. <listitem role="commit-message">
  7619. <para>Implemented feature request
  7620. #1434408 to support formatting
  7621. of <tag>biblioentry</tag>.</para>
  7622. <para role="commit-changes">Modified: fo/biblio.xsl,1.35 - Robert
  7623. Stayton</para>
  7624. </listitem>
  7625. <listitem role="commit-message">
  7626. <para>Added
  7627. <tag>biblioentry</tag>.properties.</para>
  7628. <para role="commit-changes">Modified: fo/param.ent,1.97;
  7629. fo/param.xweb,1.110 - Robert Stayton</para>
  7630. </listitem>
  7631. <listitem role="commit-message">
  7632. <para>Support PTC/Arbortext
  7633. bookmarks</para>
  7634. <para role="commit-changes">Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman
  7635. Walsh</para>
  7636. </listitem>
  7637. <listitem role="commit-message">
  7638. <para>Added
  7639. <tag>table</tag>.<tag>footnote</tag>.properties to permit
  7640. <tag>table</tag> footnotes to format differently from regular
  7641. footnotes.</para>
  7642. <para role="commit-changes">Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert
  7643. Stayton</para>
  7644. </listitem>
  7645. <listitem role="commit-message">
  7646. <para>Refactored <tag>table</tag>
  7647. templates to unify their processing and support all options in
  7648. all types. Now <tag>table</tag> and <tag>informaltable</tag>, in
  7649. both Cals and Html markup, use the same templates where possible,
  7650. and all support pgwide, rotation, and floats. There is also a
  7651. placeholder <tag>table</tag>.container template to
  7652. support wrapping a <tag>table</tag> in a layout <tag>table</tag>,
  7653. so the XEP <tag>table</tag> <tag>title</tag> "continued"
  7654. extension can be more easily implemented.</para>
  7655. <para role="commit-changes">Modified: fo/formal.xsl,1.52;
  7656. fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert
  7657. Stayton</para>
  7658. </listitem>
  7659. <listitem role="commit-message">
  7660. <para>Added new attribute set
  7661. <tag>toc</tag>.line.properties for controlling appearance of lines in
  7662. ToC/LoT</para>
  7663. <para role="commit-changes">Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95;
  7664. fo/param.xweb,1.108 - Jirka Kosek</para>
  7665. </listitem>
  7666. <listitem role="commit-message">
  7667. <para>Added support for float to example
  7668. and <tag>equation</tag>. Added support for pgwide to
  7669. <tag>figure</tag>, example, and <tag>equation</tag> (the latter
  7670. two via a dbfo pgwide="1" processing
  7671. instruction).</para>
  7672. <para role="commit-changes">Modified: fo/formal.xsl,1.51 - Robert
  7673. Stayton</para>
  7674. </listitem>
  7675. <listitem role="commit-message">
  7676. <para>Add pgwide.properties
  7677. attribute-set.</para>
  7678. <para role="commit-changes">Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert
  7679. Stayton</para>
  7680. </listitem>
  7681. <listitem role="commit-message">
  7682. <para>Added <tag>refclass</tag>.suppress
  7683. param.</para>
  7684. <para>If the value of <tag>refclass</tag>.suppress is
  7685. non-zero, then display <tag>refclass</tag> contents is suppressed
  7686. in output. Affects HTML and FO output
  7687. only.</para>
  7688. <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
  7689. html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
  7690. Smith</para>
  7691. </listitem>
  7692. <listitem role="commit-message">
  7693. <para>Improved support for
  7694. <tag>task</tag> subelements</para>
  7695. <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
  7696. Jirka Kosek</para>
  7697. </listitem>
  7698. <listitem role="commit-message">
  7699. <para>Adjusted spacing around
  7700. K&amp;R-formatted <tag>Funcdef</tag> and <tag>Paramdef</tag>
  7701. output such that it can more easily be discerned where one ends
  7702. and the other begins. Closes #1213264.</para>
  7703. <para role="commit-changes">Modified: fo/synop.xsl,1.18 -
  7704. Michael(tm) Smith</para>
  7705. </listitem>
  7706. <listitem role="commit-message">
  7707. <para>Made handling of
  7708. paramdef/parameter in FO output consistent with that in HTML and
  7709. manpages output. Closes #1213259.</para>
  7710. <para role="commit-changes">Modified: fo/synop.xsl,1.17 - Michael(tm)
  7711. Smith</para>
  7712. </listitem>
  7713. <listitem role="commit-message">
  7714. <para>Made handling of
  7715. <tag>Refnamediv</tag> consistent with formatting in HTML
  7716. and manpages output; specifically, changed so that
  7717. <tag>Refname</tag> (comma-separated list of multiple instances
  7718. found) is used (instead of <tag>Refentrytitle</tag> as
  7719. previously), then em-dash, then the <tag>Refpurpose</tag>. Closes
  7720. #1212562.</para>
  7721. <para role="commit-changes">Modified: fo/refentry.xsl,1.30 - Michael(tm)
  7722. Smith</para>
  7723. </listitem>
  7724. <listitem role="commit-message">
  7725. <para>Added output of
  7726. <tag>Releaseinfo</tag> to recto titlepage ("<tag>copyright</tag>"
  7727. page) for <tag>Book</tag> in FO output. This makes it consistent
  7728. with HTML output. Closes #1327034. Thanks to Paul DuBois for
  7729. reporting.</para>
  7730. <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.28 - Michael(tm)
  7731. Smith</para>
  7732. </listitem>
  7733. <listitem role="commit-message">
  7734. <para>Added condition for setting
  7735. block-progression-dimension.minimum on table-row, instead of
  7736. height, when <parameter>fop1.extensions</parameter> is
  7737. non-zero. For an explanation of the reason for the change,
  7738. <tag>see</tag>: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages</para>
  7739. <para role="commit-changes">Modified: fo/pagesetup.xsl,1.59
  7740. - Michael(tm) Smith</para>
  7741. </listitem>
  7742. <listitem role="commit-message">
  7743. <para>Added new
  7744. <tag>refclass</tag>.suppress param for suppressing display
  7745. of <tag>Refclass</tag> in HTML and FO output. Did not add it to
  7746. manpages because manpages stylesheet is currently just silently
  7747. ignoring <tag>Refclass</tag> anyway. Closes request
  7748. #1461065. Thanks to Davor Ocelic (docelic) for
  7749. reporting.</para>
  7750. <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
  7751. Michael(tm) Smith</para>
  7752. </listitem>
  7753. <listitem role="commit-message">
  7754. <para>Add support for keep-together PI
  7755. to informal objects.</para>
  7756. <para role="commit-changes">Modified: fo/formal.xsl,1.50 - Robert
  7757. Stayton</para>
  7758. </listitem>
  7759. <listitem role="commit-message">
  7760. <para>Add support for
  7761. <parameter>fop1.extensions</parameter>.</para>
  7762. <para role="commit-changes">Modified: fo/formal.xsl,1.49;
  7763. fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert
  7764. Stayton</para>
  7765. </listitem>
  7766. <listitem role="commit-message">
  7767. <para>Add support for fop1
  7768. bookmarks.</para>
  7769. <para role="commit-changes">Modified: fo/docbook.xsl,1.39 - Robert
  7770. Stayton</para>
  7771. </listitem>
  7772. <listitem role="commit-message">
  7773. <para>Add fop1.extentions parameter to
  7774. add support for fop development version.</para>
  7775. <para role="commit-changes">Modified: fo/param.ent,1.92;
  7776. fo/param.xweb,1.105 - Robert Stayton</para>
  7777. </listitem>
  7778. <listitem role="commit-message">
  7779. <para>Start supporting fop development
  7780. version, which will become fop version 1.</para>
  7781. <para role="commit-changes">Modified: fo/fop1.xsl,1.1 -
  7782. Robert Stayton</para>
  7783. </listitem>
  7784. <listitem role="commit-message">
  7785. <para>Add template for <tag>task</tag>
  7786. in mode="xref-to".</para>
  7787. <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
  7788. Stayton</para>
  7789. </listitem>
  7790. <listitem role="commit-message">
  7791. <para><tag>table</tag> footnotes now
  7792. also get <tag>footnote</tag>.properties
  7793. attribute-set.</para>
  7794. <para role="commit-changes">Modified: fo/footnote.xsl,1.22 - Robert
  7795. Stayton</para>
  7796. </listitem>
  7797. <listitem role="commit-message">
  7798. <para>Added <tag>index</tag>.separator
  7799. named template to compute the separator punctuation based on
  7800. locale.</para>
  7801. <para role="commit-changes">Modified: fo/autoidx.xsl,1.36 - Robert Stayton</para>
  7802. </listitem>
  7803. <listitem role="commit-message">
  7804. <para>Added support for <tag>link</tag>,
  7805. <tag>olink</tag>, and <tag>xref</tag> within OO
  7806. <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
  7807. allows it).</para>
  7808. <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
  7809. Smith</para>
  7810. </listitem>
  7811. <listitem role="commit-message">
  7812. <para>Support <tag>date</tag> as an
  7813. inline</para>
  7814. <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
  7815. Walsh</para>
  7816. </listitem>
  7817. <listitem role="commit-message">
  7818. <para>Added new parameter
  7819. <parameter>keep.relative.image.uris</parameter></para>
  7820. <para role="commit-changes">Modified: fo/param.ent,1.91;
  7821. fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
  7822. params/keep.relative.image.uris.xml,1.1 - Norman
  7823. Walsh</para>
  7824. </listitem>
  7825. <listitem role="commit-message">
  7826. <para>Map Unicode space characters
  7827. U+2000-U+200A to fo:leaders.</para>
  7828. <para role="commit-changes">Modified: fo/docbook.xsl,1.38;
  7829. fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka
  7830. Kosek</para>
  7831. </listitem>
  7832. <listitem role="commit-message">
  7833. <para>Output a real em dash for em-dash
  7834. dingbat (instead of two hypens).</para>
  7835. <para role="commit-changes">Modified: fo/fo.xsl,1.7 - Michael(tm)
  7836. Smith</para>
  7837. </listitem>
  7838. <listitem role="commit-message">
  7839. <para>Support default <tag>label</tag>
  7840. width parameters for itemized and ordered lists</para>
  7841. <para role="commit-changes">Modified: fo/lists.xsl,1.64;
  7842. fo/param.ent,1.90; fo/param.xweb,1.103;
  7843. params/itemizedlist.label.width.xml,1.1;
  7844. params/orderedlist.label.width.xml,1.1 - Norman
  7845. Walsh</para>
  7846. </listitem>
  7847. <listitem role="commit-message">
  7848. <para>Generate localized
  7849. <tag>title</tag> for <tag>Refsynopsisdiv</tag> if no
  7850. appropriate <tag>Title</tag> descendant found in source. Closes
  7851. #1212398. This change makes behavior for the <tag>Synopsis</tag>
  7852. <tag>title</tag> consistent with the behavior of HTML and
  7853. manpages output.</para>
  7854. <para>Also, added
  7855. xsl:use-attribute-sets="normal.<tag>para</tag>.spacing" to
  7856. block generated for <tag>Cmdsynopsis</tag> output. Previously,
  7857. that block had no spacing at all specified, which resulted it
  7858. being crammed up to closely to the <tag>Synopsis</tag>
  7859. head.</para>
  7860. <para role="commit-changes">Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm)
  7861. Smith</para>
  7862. </listitem>
  7863. <listitem role="commit-message">
  7864. <para>Added parameters to support
  7865. localization of <tag>index</tag>
  7866. item punctuation.</para>
  7867. <para role="commit-changes">Modified: fo/autoidx.xsl,1.35 - Robert
  7868. Stayton</para>
  7869. </listitem>
  7870. <listitem role="commit-message">
  7871. <para>Added
  7872. <parameter>index.number.separator</parameter>,
  7873. <parameter>index.range.separator</parameter>,
  7874. and <parameter>index.term.separator</parameter> parameters to
  7875. support localization of punctuation in <tag>index</tag>
  7876. entries.</para>
  7877. <para role="commit-changes">Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert
  7878. Stayton</para>
  7879. </listitem>
  7880. <listitem role="commit-message">
  7881. <para>Added "Cross References"
  7882. <tag>section</tag> in HTML doc (for consistency with the FO
  7883. doc). Also, moved the existing FO "Cross
  7884. References" <tag>section</tag> to follow the "Linking"
  7885. <tag>section</tag>.</para>
  7886. <para role="commit-changes">Modified: fo/param.xweb,1.101; html/param.xweb,1.95 -
  7887. Michael(tm) Smith</para>
  7888. </listitem>
  7889. <listitem role="commit-message">
  7890. <para>Added ID attribues to all
  7891. <tag>Reference</tag> elements (e.g., id="tables" for the doc for
  7892. <tag>section</tag> on <tag>Table</tag> params). So pages for
  7893. all subsections of ref docs now have stable filenames instead
  7894. of arbitrary generated filenames.</para>
  7895. <para role="commit-changes">Modified: fo/param.xweb,1.100;
  7896. html/param.xweb,1.94 - Michael(tm) Smith</para>
  7897. </listitem>
  7898. <listitem role="commit-message">
  7899. <para>Added two new parameters for
  7900. handling of multi-term
  7901. <tag>varlistentry</tag> elements:</para>
  7902. <para><parameter>variablelist.term.break.after</parameter>:
  7903. When the <parameter>variablelist.term.break.after</parameter> is
  7904. non-zero, it will generate a line break after each
  7905. <tag>term</tag> multi-term
  7906. <tag>varlistentry</tag>.</para>
  7907. <para><parameter>variablelist.term.separator</parameter>:
  7908. When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
  7909. elements, the string specified in the value of the
  7910. <parameter>variablelist.term.separator</parameter> parameter is
  7911. placed after each <tag>term</tag> except the last. The default
  7912. is ", " (a comma followed by a space). To suppress rendering of
  7913. the separator, set the value of
  7914. <parameter>variablelist.term.separator</parameter> to the empty
  7915. string ("").</para>
  7916. <para>These parameters are primarily intended to be
  7917. useful if you have multi-term varlistentries that have long
  7918. terms.</para>
  7919. <para>Closes #1306676. Thanks to Sam Steingold for
  7920. providing an example "lots of long terms" doc that demonstrated
  7921. the value of having these options.</para>
  7922. <para>Also, added
  7923. normalize-space() call to processing of each
  7924. <tag>term</tag>.</para>
  7925. <para>This change affects all output formats
  7926. (HTML, PDF, manpages). The default behavior should pretty much
  7927. remain the same as before, but it is possible (as always) that
  7928. the change may introduce some
  7929. new bugginess.</para>
  7930. <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
  7931. fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
  7932. html/param.xweb,1.93; manpages/lists.xsl,1.22;
  7933. manpages/param.ent,1.14; manpages/param.xweb,1.16;
  7934. params/variablelist.term.break.after.xml,1.1;
  7935. params/variablelist.term.separator.xml,1.1 - Michael(tm)
  7936. Smith</para>
  7937. </listitem>
  7938. <listitem role="commit-message">
  7939. <para>Add <tag>sidebar</tag> titlepage
  7940. placeholder attset for styles.</para>
  7941. <para role="commit-changes">Modified: fo/titlepage.xsl,1.37 - Robert
  7942. Stayton</para>
  7943. </listitem>
  7944. <listitem role="commit-message">
  7945. <para>Add titlepage for
  7946. <tag>sidebar</tag>.</para>
  7947. <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.27 - Robert
  7948. Stayton</para>
  7949. </listitem>
  7950. <listitem role="commit-message">
  7951. <para>Implemented RFE
  7952. #1292615.</para>
  7953. <para>Added bunch of new parameters (attribute sets)
  7954. that affect list presentation: list.block.properties,
  7955. <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
  7956. <tag>itemizedlist</tag>.<tag>label</tag>.properties and
  7957. <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
  7958. of stylesheets has not been changed but further customizations will be
  7959. much more easier.</para>
  7960. <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
  7961. fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
  7962. params/itemizedlist.properties.xml,1.1;
  7963. params/list.block.properties.xml,1.1;
  7964. params/orderedlist.label.properties.xml,1.1;
  7965. params/orderedlist.properties.xml,1.1 - Jirka
  7966. Kosek</para>
  7967. </listitem>
  7968. <listitem role="commit-message">
  7969. <para>Implemented RFE
  7970. #1242092.</para>
  7971. <para>You can enable crop marks in your document by
  7972. setting crop.marks=1 and xep.extensions=1. Appearance of crop
  7973. marks can be controlled by parameters
  7974. <parameter>crop.mark.bleed</parameter> (6pt),
  7975. <parameter>crop.mark.offset</parameter> (24pt) and
  7976. <parameter>crop.mark.width</parameter> (0.5pt).</para>
  7977. <para>Also there
  7978. is new named template called user-xep-pis. You can overwrite it in
  7979. order to produce some PIs that can control XEP as described in
  7980. http://www.renderx.com/reference.html#Output_Formats</para>
  7981. <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
  7982. fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
  7983. params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
  7984. params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
  7985. Kosek</para>
  7986. </listitem>
  7987. </itemizedlist>
  7988. </sect2><!--end of FO changes for snapshot_2006-05-15_0803-->
  7989. <sect2 xml:id="V1700_HTML">
  7990. <title>HTML</title>
  7991. <para>The following changes have been made to the
  7992. <filename>html</filename> code
  7993. since the 1.69.1 release.</para>
  7994. <itemizedlist>
  7995. <listitem role="commit-message">
  7996. <para>implemented
  7997. <tag>index</tag>.method parameter and three
  7998. methods.</para>
  7999. <para role="commit-changes">Modified: html/autoidx.xsl,1.28 - Robert
  8000. Stayton</para>
  8001. </listitem>
  8002. <listitem role="commit-message">
  8003. <para>added <tag>index</tag>.method
  8004. parameter to support 3 indexing methods.</para>
  8005. <para role="commit-changes">Modified: html/param.ent,1.94;
  8006. html/param.xweb,1.103 - Robert Stayton</para>
  8007. </listitem>
  8008. <listitem role="commit-message">
  8009. <para>Implemented feature request
  8010. #1072510 as a processing instruction to permit including external
  8011. HTML content into HTML output.</para>
  8012. <para role="commit-changes">Modified: html/pi.xsl,1.9 - Robert
  8013. Stayton</para>
  8014. </listitem>
  8015. <listitem role="commit-message">
  8016. <para>Added new parameter
  8017. <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
  8018. controls presence of <tag>title</tag> in a separate chunk with
  8019. ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
  8020. generating frameset output (well, yes those frames, but some customers
  8021. really want them ;-).</para>
  8022. <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
  8023. html/param.ent,1.93; html/param.xweb,1.102;
  8024. params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
  8025. Kosek</para>
  8026. </listitem>
  8027. <listitem role="commit-message">
  8028. <para>Support dbhtml/dbfo start PI for
  8029. <tag>orderedlist</tag> numbering in both HTML and
  8030. FO</para>
  8031. <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
  8032. Walsh</para>
  8033. </listitem>
  8034. <listitem role="commit-message">
  8035. <para>Allow <tag>ToC</tag> without
  8036. <tag>title</tag> also for set and
  8037. <tag>book</tag>.</para>
  8038. <para role="commit-changes">Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 -
  8039. Jirka Kosek</para>
  8040. </listitem>
  8041. <listitem role="commit-message">
  8042. <para>Implemented floats uniformly for
  8043. <tag>figure</tag>, example, <tag>equation</tag>
  8044. and <tag>informalfigure</tag>, <tag>informalexample</tag>, and
  8045. <tag>informalequation</tag>.</para>
  8046. <para role="commit-changes">Modified: html/formal.xsl,1.22 - Robert
  8047. Stayton</para>
  8048. </listitem>
  8049. <listitem role="commit-message">
  8050. <para>Added the
  8051. autotoc.<tag>label</tag>.in.hyperlink param.</para>
  8052. <para>If the value
  8053. of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
  8054. are included in hyperlinked titles in the <tag>TOC</tag>. If it
  8055. is instead zero, labels are still displayed prior to the
  8056. hyperlinked titles, but are not hyperlinked along with the
  8057. titles.</para>
  8058. <para>Closes patch #1065868. Thanks to anatoly techtonik
  8059. for the patch.</para>
  8060. <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
  8061. html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
  8062. Michael(tm) Smith</para>
  8063. </listitem>
  8064. <listitem role="commit-message">
  8065. <para>Added two new params:
  8066. html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
  8067. and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
  8068. <para>If
  8069. the value of the <parameter>generate.legalnotice.link</parameter> is
  8070. non-zero, then the stylesheet generates (in the head
  8071. <tag>section</tag> of the HTML source) either a single HTML
  8072. <tag>link</tag> element or, if the value of
  8073. the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
  8074. non-zero, one <tag>link</tag> element for each <tag>link</tag>
  8075. type specified. Each <tag>link</tag> has the
  8076. following attributes:</para>
  8077. <para> - a rel attribute whose value
  8078. is derived from the value of
  8079. html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
  8080. <para> -
  8081. an href attribute whose value is set to the URL of the file
  8082. containing the <tag>legalnotice</tag></para>
  8083. <para> - a <tag>title</tag>
  8084. attribute whose value is set to the <tag>title</tag> of the
  8085. corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
  8086. programatically determined by the stylesheet)</para>
  8087. <para>For
  8088. example:</para>
  8089. <para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
  8090. href="ln-id2524073.html" title="Legal Notice"&gt;</para>
  8091. <para>Closes
  8092. #1476450. Thanks to Sam Steingold.</para>
  8093. <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
  8094. html/param.ent,1.91; html/param.xweb,1.100;
  8095. params/generate.legalnotice.link.xml,1.4;
  8096. params/html.head.legalnotice.link.multiple.xml,1.1;
  8097. params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
  8098. Smith</para>
  8099. </listitem>
  8100. <listitem role="commit-message">
  8101. <para>Added <tag>refclass</tag>.suppress
  8102. param.</para>
  8103. <para>If the value of <tag>refclass</tag>.suppress is
  8104. non-zero, then display <tag>refclass</tag> contents is suppressed
  8105. in output. Affects HTML and FO output
  8106. only.</para>
  8107. <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
  8108. html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
  8109. Smith</para>
  8110. </listitem>
  8111. <listitem role="commit-message">
  8112. <para>Improved support for
  8113. <tag>task</tag> subelements</para>
  8114. <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
  8115. Jirka Kosek</para>
  8116. </listitem>
  8117. <listitem role="commit-message">
  8118. <para>Added new
  8119. <tag>refclass</tag>.suppress param for suppressing display
  8120. of <tag>Refclass</tag> in HTML and FO output. Did not add it to
  8121. manpages because manpages stylesheet is currently just silently
  8122. ignoring <tag>Refclass</tag> anyway. Closes request
  8123. #1461065. Thanks to Davor Ocelic (docelic) for
  8124. reporting.</para>
  8125. <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
  8126. Michael(tm) Smith</para>
  8127. </listitem>
  8128. <listitem role="commit-message">
  8129. <para>Process <tag>alt</tag> text with
  8130. normalize-space(). Replace tab indents with
  8131. spaces.</para>
  8132. <para role="commit-changes">Modified: html/graphics.xsl,1.57 - Robert
  8133. Stayton</para>
  8134. </listitem>
  8135. <listitem role="commit-message">
  8136. <para>Content of <tag>citation</tag>
  8137. element is automatically linked to the bibliographic <tag>entry</tag>
  8138. with the corresponding <tag>abbrev</tag>.</para>
  8139. <para role="commit-changes">Modified: html/biblio.xsl,1.26;
  8140. html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka
  8141. Kosek</para>
  8142. </listitem>
  8143. <listitem role="commit-message">
  8144. <para>Add template for <tag>task</tag>
  8145. in mode="xref-to".</para>
  8146. <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
  8147. Stayton</para>
  8148. </listitem>
  8149. <listitem role="commit-message">
  8150. <para>Suppress ID warnings if the
  8151. .warnings parameter is 0</para>
  8152. <para role="commit-changes">Modified: html/html.xsl,1.17 - Norman
  8153. Walsh</para>
  8154. </listitem>
  8155. <listitem role="commit-message">
  8156. <para>Add support for floatstyle to
  8157. <tag>figure</tag>.</para>
  8158. <para role="commit-changes">Modified: html/formal.xsl,1.21 - Robert
  8159. Stayton</para>
  8160. </listitem>
  8161. <listitem role="commit-message">
  8162. <para>Handling of <tag>xref</tag> to
  8163. area/areaset need support in extensions code also. I currently have no
  8164. time to touch extensions code, so code is here to be enabled when
  8165. extension is fixed also.</para>
  8166. <para role="commit-changes">Modified: html/xref.xsl,1.56 - Jirka
  8167. Kosek</para>
  8168. </listitem>
  8169. <listitem role="commit-message">
  8170. <para>Added 3 parameters for overriding
  8171. gentext for <tag>index</tag>
  8172. punctuation.</para>
  8173. <para role="commit-changes">Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert
  8174. Stayton</para>
  8175. </listitem>
  8176. <listitem role="commit-message">
  8177. <para>Added parameters to support
  8178. localization of <tag>index</tag> item punctuation. Added
  8179. <tag>index</tag>.separator named template to compute
  8180. the separator punctuation based on
  8181. locale.</para>
  8182. <para role="commit-changes">Modified: html/autoidx.xsl,1.27 - Robert
  8183. Stayton</para>
  8184. </listitem>
  8185. <listitem role="commit-message">
  8186. <para>Added a &lt;div
  8187. class="{$class}-contents"&gt; wrapper around output of contents
  8188. of all formal objects. Also, added an optional &lt;br
  8189. class="{class}-break"/&gt; linebreak after all formal
  8190. objects.</para>
  8191. <para>WARNING: Because this change places an additional
  8192. DIV between the DIV wrapper for the <tag>equation</tag> and the
  8193. <tag>equation</tag> contents, it may break some existing CSS
  8194. stylesheets that have been created with the assumption that there
  8195. would never be an intervening DIV there.</para>
  8196. <para>The following is
  8197. an example of what <tag>Equation</tag> output looks like as a
  8198. result of the changes described above.</para>
  8199. <para> &lt;div
  8200. class="<tag>equation</tag>"&gt; &lt;a name="three"
  8201. id="three"&gt;&lt;/a&gt;</para>
  8202. <para> &lt;p
  8203. class="<tag>title</tag>"&gt;&lt;b&gt;(1.3)&lt;/b&gt;&lt;/p&gt;</para>
  8204. <para>
  8205. &lt;div class="equation-contents"&gt; &lt;span
  8206. class="<tag>mathphrase</tag>"&gt;1+1=3&lt;/span&gt;
  8207. &lt;/div&gt; &lt;/div&gt;&lt;br
  8208. class="equation-break"&gt;</para>
  8209. <para>Rationale: These changes allow
  8210. CSS control of the placement of the formal-object
  8211. <tag>title</tag> relative to the formal-object
  8212. contents. For example, using the CSS "float" <tag>property</tag>
  8213. enables the <tag>title</tag> and contents to be rendered on the
  8214. same line. Example stylesheet:</para>
  8215. <para> .<tag>equation</tag>
  8216. { margin-top: 20px; margin-bottom: 20px; }
  8217. .equation-contents { float: left; }</para>
  8218. <para>
  8219. .<tag>equation</tag> .<tag>title</tag> { margin-top: 0;
  8220. float: right; margin-right: 200px; }</para>
  8221. <para>
  8222. .<tag>equation</tag> .<tag>title</tag> b { font-weight:
  8223. normal; }</para>
  8224. <para> .equation-break { clear: both;
  8225. }</para>
  8226. <para>Note that the purpose of the ".equation-break" class is
  8227. to provide a way to clear off the floats.</para>
  8228. <para>If you want
  8229. to instead have the <tag>equation</tag> <tag>title</tag> rendered to
  8230. the left of the <tag>equation</tag> contents, you can do
  8231. something like this:</para>
  8232. <para> .<tag>equation</tag> {
  8233. margin-top: 20px; width: 300px; margin-bottom: 20px;
  8234. } .equation-contents { float: right; }</para>
  8235. <para>
  8236. .<tag>equation</tag> .<tag>title</tag> { margin-top: 0;
  8237. float: left; margin-right: 200px; }</para>
  8238. <para>
  8239. .<tag>equation</tag> .<tag>title</tag> b { font-weight:
  8240. normal; }</para>
  8241. <para> .equation-break { clear: both;
  8242. }</para>
  8243. <para role="commit-changes">Modified: html/formal.xsl,1.20 - Michael(tm) Smith</para>
  8244. </listitem>
  8245. <listitem role="commit-message">
  8246. <para>Added a chunker.output.quiet
  8247. top-level parameter so that the chunker can be made quiet by
  8248. default</para>
  8249. <para role="commit-changes">Modified: html/chunker.xsl,1.26 - Norman Walsh</para>
  8250. </listitem>
  8251. <listitem role="commit-message">
  8252. <para>Added support for <tag>link</tag>,
  8253. <tag>olink</tag>, and <tag>xref</tag> within OO
  8254. <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
  8255. allows it).</para>
  8256. <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
  8257. Smith</para>
  8258. </listitem>
  8259. <listitem role="commit-message">
  8260. <para>New parameter:
  8261. <parameter>id.warnings</parameter>. If non-zero, warnings are
  8262. generated for titled objects that don't have titles. True by default;
  8263. I wonder if this will be too aggressive?</para>
  8264. <para role="commit-changes">Modified: html/biblio.xsl,1.25;
  8265. html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
  8266. html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
  8267. html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
  8268. html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
  8269. Walsh</para>
  8270. </listitem>
  8271. <listitem role="commit-message">
  8272. <para>If the
  8273. <parameter>keep.relative.image.uris</parameter> parameter is true,
  8274. don't use the absolute <tag>URI</tag> (as calculated from xml:base) in
  8275. the img src attribute, us the value the <tag>author</tag>
  8276. specified. Note that we still have to calculate the absolute
  8277. <tag>filename</tag> for use in the image intrinsics
  8278. extension.</para>
  8279. <para role="commit-changes">Modified: html/graphics.xsl,1.56 - Norman
  8280. Walsh</para>
  8281. </listitem>
  8282. <listitem role="commit-message">
  8283. <para>Support <tag>date</tag> as an
  8284. inline</para>
  8285. <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
  8286. Walsh</para>
  8287. </listitem>
  8288. <listitem role="commit-message">
  8289. <para>Added new parameter
  8290. <parameter>keep.relative.image.uris</parameter></para>
  8291. <para role="commit-changes">Modified: fo/param.ent,1.91;
  8292. fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
  8293. params/keep.relative.image.uris.xml,1.1 - Norman
  8294. Walsh</para>
  8295. </listitem>
  8296. <listitem role="commit-message">
  8297. <para>Added two new parameters for
  8298. handling of multi-term
  8299. <tag>varlistentry</tag> elements:</para>
  8300. <para><parameter>variablelist.term.break.after</parameter>:
  8301. When the <parameter>variablelist.term.break.after</parameter> is
  8302. non-zero, it will generate a line break after each
  8303. <tag>term</tag> multi-term
  8304. <tag>varlistentry</tag>.</para>
  8305. <para><parameter>variablelist.term.separator</parameter>:
  8306. When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
  8307. elements, the string specified in the value of the
  8308. <parameter>variablelist.term.separator</parameter> parameter is
  8309. placed after each <tag>term</tag> except the last. The default
  8310. is ", " (a comma followed by a space). To suppress rendering of
  8311. the separator, set the value of
  8312. <parameter>variablelist.term.separator</parameter> to the empty
  8313. string ("").</para>
  8314. <para>These parameters are primarily intended to be
  8315. useful if you have multi-term varlistentries that have long
  8316. terms.</para>
  8317. <para>Closes #1306676. Thanks to Sam Steingold for
  8318. providing an example "lots of long terms" doc that demonstrated
  8319. the value of having these options.</para>
  8320. <para>Also, added
  8321. normalize-space() call to processing of each
  8322. <tag>term</tag>.</para>
  8323. <para>This change affects all output formats
  8324. (HTML, PDF, manpages). The default behavior should pretty much
  8325. remain the same as before, but it is possible (as always) that
  8326. the change may introduce some
  8327. new bugginess.</para>
  8328. <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
  8329. fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
  8330. html/param.xweb,1.93; manpages/lists.xsl,1.22;
  8331. manpages/param.ent,1.14; manpages/param.xweb,1.16;
  8332. params/variablelist.term.break.after.xml,1.1;
  8333. params/variablelist.term.separator.xml,1.1 - Michael(tm)
  8334. Smith</para>
  8335. </listitem>
  8336. <listitem role="commit-message">
  8337. <para>Added "wrapper-name" param to
  8338. inline.charseq named template, enabling it to output inlines
  8339. other than just "span". <tag>Acronym</tag> and <tag>Abbrev</tag>
  8340. templates now use inline.charseq to output HTML
  8341. "<tag>acronym</tag>" and "abbr" elements (instead of
  8342. "span"). Closes #1305468. Thanks to Sam Steingold for suggesting
  8343. the change.</para>
  8344. <para role="commit-changes">Modified: html/inline.xsl,1.45 - Michael(tm)
  8345. Smith</para>
  8346. </listitem>
  8347. </itemizedlist>
  8348. </sect2><!--end of HTML changes for snapshot_2006-05-15_0803-->
  8349. <sect2 xml:id="V1700_Manpages">
  8350. <title>Manpages</title>
  8351. <para>The following changes have been made to the
  8352. <filename>manpages</filename> code
  8353. since the 1.69.1 release.</para>
  8354. <itemizedlist>
  8355. <listitem role="commit-message">
  8356. <para>Added the following
  8357. params:</para>
  8358. <para> - man.indent.width (string-valued) -
  8359. man.indent.refsect (boolean) - man.indent.blurbs (boolean)
  8360. - man.indent.lists (boolean) - man.indent.verbatims
  8361. (boolean)</para>
  8362. <para>Note that in earlier snapshots, man.indent.width
  8363. was named man.indentation.default.value and the boolean params
  8364. had names like man.indentation.*.adjust. Also the
  8365. man.indent.blurbs param was called man.indentation.authors.adjust
  8366. (or something).</para>
  8367. <para>The behavior now is: If the value of a
  8368. particular man.indent.* boolean param is non-zero, the
  8369. corresponding contents (refsect*, list items,
  8370. authorblurb/personblurb, vervatims) are displayed with a left
  8371. margin indented by a width equal to the value
  8372. of man.indent.width.</para>
  8373. <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
  8374. manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
  8375. manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
  8376. manpages/param.ent,1.22; manpages/param.xweb,1.24;
  8377. manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
  8378. params/man.indent.refsect.xml,1.1;
  8379. params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
  8380. Michael(tm) Smith</para>
  8381. </listitem>
  8382. <listitem role="commit-message">
  8383. <para>Added
  8384. man.<tag>table</tag>.footnotes.divider param.</para>
  8385. <para>In each
  8386. <tag>table</tag> that contains footenotes, the string specified
  8387. by the man.<tag>table</tag>.footnotes.divider parameter is output
  8388. before the list of footnotes for the
  8389. <tag>table</tag>.</para>
  8390. <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
  8391. manpages/links.xsl,1.6; manpages/param.ent,1.21;
  8392. manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
  8393. Michael(tm) Smith</para>
  8394. </listitem>
  8395. <listitem role="commit-message">
  8396. <para>Added the
  8397. man.output.in.separate.dir,
  8398. man.output.<parameter>base.dir</parameter>,
  8399. and man.output.subdirs.enabled parameters.</para>
  8400. <para>The
  8401. man.output.<parameter>base.dir</parameter> parameter specifies the
  8402. base directory into which man-page files are
  8403. output. The man.output.subdirs.enabled parameter controls whether
  8404. the files are output in subdirectories within the base
  8405. directory.</para>
  8406. <para>The values of the
  8407. man.output.<parameter>base.dir</parameter>
  8408. and man.output.subdirs.enabled parameters are used only if the
  8409. value of man.output.in.separate.dir parameter is non-zero. If the
  8410. value of man.output.in.separate.dir is zero, man-page files are
  8411. not output in a separate
  8412. directory.</para>
  8413. <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
  8414. manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
  8415. params/man.output.in.separate.dir.xml,1.1;
  8416. params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
  8417. Smith</para>
  8418. </listitem>
  8419. <listitem role="commit-message">
  8420. <para>Added
  8421. man.font.<tag>table</tag>.headings and
  8422. man.font.<tag>table</tag>.<tag>title</tag> params, for
  8423. controlling font in <tag>table</tag> headings and
  8424. titles.</para>
  8425. <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
  8426. manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
  8427. params/man.font.table.title.xml,1.1 - Michael(tm)
  8428. Smith</para>
  8429. </listitem>
  8430. <listitem role="commit-message">
  8431. <para>Added
  8432. man.font.<tag>funcsynopsisinfo</tag> and
  8433. man.font.<tag>funcprototype</tag> params, for specifying the roff
  8434. font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
  8435. <tag>funcprototype</tag> output.</para>
  8436. <para role="commit-changes">Modified: manpages/block.xsl,1.19;
  8437. manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
  8438. manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
  8439. manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
  8440. params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
  8441. Smith</para>
  8442. </listitem>
  8443. <listitem role="commit-message">
  8444. <para>Added
  8445. man.<tag>segtitle</tag>.suppress param.</para>
  8446. <para>If the value of
  8447. man.<tag>segtitle</tag>.suppress is non-zero, then display
  8448. of <tag>segtitle</tag> contents is suppressed in
  8449. output.</para>
  8450. <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
  8451. manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
  8452. Michael(tm) Smith</para>
  8453. </listitem>
  8454. <listitem role="commit-message">
  8455. <para>Added
  8456. man.output.<parameter>manifest</parameter>.enabled and
  8457. man.output.manifest.<tag>filename</tag> params.</para>
  8458. <para>If
  8459. man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
  8460. of filenames for man pages generated by the stylesheet
  8461. transformation is written to the file named by
  8462. man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
  8463. <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
  8464. manpages/other.xsl,1.19; manpages/param.ent,1.16;
  8465. manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
  8466. params/man.output.manifest.filename.xml,1.1;
  8467. tools/make/Makefile.DocBook,1.4 - Michael(tm)
  8468. Smith</para>
  8469. </listitem>
  8470. <listitem role="commit-message">
  8471. <para>Added
  8472. <tag>refentry</tag>.meta.get.quietly param.</para>
  8473. <para>If zero (the
  8474. default), notes and warnings about "missing" markup are generated
  8475. during gathering of <tag>refentry</tag> metadata. If
  8476. non-zero, the metadata is gathered "quietly" -- that is, the
  8477. notes and warnings are suppressed.</para>
  8478. <para>NOTE: If you are
  8479. processing a large amount of <tag>refentry</tag> content, you
  8480. may be able to speed up processing significantly by setting a
  8481. non-zero value for
  8482. <tag>refentry</tag>.meta.get.quietly.</para>
  8483. <para role="commit-changes">Modified: common/refentry.xsl,1.17;
  8484. manpages/param.ent,1.15; manpages/param.xweb,1.17;
  8485. params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
  8486. Smith</para>
  8487. </listitem>
  8488. <listitem role="commit-message">
  8489. <para>Changed names of all boolean
  8490. indentation params to man.indent.* Also discarded individual
  8491. man.indent.*.value params and switched to just using a common
  8492. man.indent.width param (3n by default).</para>
  8493. <para role="commit-changes">Modified: manpages/docbook.xsl,1.66;
  8494. manpages/info.xsl,1.19; manpages/lists.xsl,1.29;
  8495. manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm)
  8496. Smith</para>
  8497. </listitem>
  8498. <listitem role="commit-message">
  8499. <para>Added boolean
  8500. man.output.in.separate.dir param, to control whether or not man
  8501. files are output in separate directory.</para>
  8502. <para role="commit-changes">Modified: manpages/docbook.xsl,1.65;
  8503. manpages/utility.xsl,1.14 - Michael(tm) Smith</para>
  8504. </listitem>
  8505. <listitem role="commit-message">
  8506. <para>Added options for controlling
  8507. indentation of verbatim output. Controlled through the
  8508. man.indentation.verbatims.adjust
  8509. and man.indentation.verbatims.value params. Closes
  8510. #1242997</para>
  8511. <para role="commit-changes">Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 -
  8512. Michael(tm) Smith</para>
  8513. </listitem>
  8514. <listitem role="commit-message">
  8515. <para>Added options for controlling
  8516. indentation in lists and in *blurb output in the AUTHORS
  8517. <tag>section</tag>. Controlled through
  8518. the man.indentation.lists.adjust,
  8519. man.indentation.lists.value, man.indentation.authors.adjust, and
  8520. man.indentation.authors.value parameters. Default is 3 characters
  8521. (instead of the roff default of 8 characters). Closes
  8522. #1449369.</para>
  8523. <para>Also, removed the indent that was being set on
  8524. <tag>informalexample</tag> outuput. I will instead add an option
  8525. for indenting verbatims, which I think is what the
  8526. <tag>informalexample</tag> indent was intended
  8527. for originally.</para>
  8528. <para role="commit-changes">Modified: manpages/block.xsl,1.14;
  8529. manpages/docbook.xsl,1.63; manpages/info.xsl,1.18;
  8530. manpages/lists.xsl,1.28 - Michael(tm) Smith</para>
  8531. </listitem>
  8532. <listitem role="commit-message">
  8533. <para>Changed line-spacing call before
  8534. <tag>synopfragment</tag> to use ".sp -1n" ("n" units specified)
  8535. instead of plain ".sp -1"</para>
  8536. <para role="commit-changes">Modified: manpages/synop.xsl,1.28 - Michael(tm)
  8537. Smith</para>
  8538. </listitem>
  8539. <listitem role="commit-message">
  8540. <para>Added support for writing man
  8541. files into a specific output directory and into appropriate
  8542. subdirectories within that output directory. Controlled through
  8543. the man.<parameter>base.dir</parameter> parameter (similar to the
  8544. <parameter>base.dir</parameter> support in the HTML stylesheet) and
  8545. the man.subdirs.enabled parameter, which automatically determines
  8546. the name of an appropriate subdir (for example, man/man7,
  8547. man/man1, etc.) based on the <tag>section</tag> number/manvolnum
  8548. of the source <tag>Refentry</tag>.</para>
  8549. <para>Closes #1255036 and
  8550. #1170317. Thanks to Denis Bradford for the original feature
  8551. request, and to Costin Stroie for submitting a patch that was
  8552. very helpful in implementing the
  8553. support.</para>
  8554. <para role="commit-changes">Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 -
  8555. Michael(tm) Smith</para>
  8556. </listitem>
  8557. <listitem role="commit-message">
  8558. <para>Refined XPath statements and
  8559. notification messages for <tag>refentry</tag> metadata
  8560. handling.</para>
  8561. <para role="commit-changes">Modified: common/common.xsl,1.59; common/refentry.xsl,1.14;
  8562. manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm)
  8563. Smith</para>
  8564. </listitem>
  8565. <listitem role="commit-message">
  8566. <para>Added support for
  8567. <tag>copyright</tag> and <tag>legalnotice</tag>. The manpages
  8568. stylesheets now output a <tag>COPYRIGHT</tag> <tag>section</tag>,
  8569. after the AUTHORS <tag>section</tag>, if a <tag>copyright</tag>
  8570. or <tag>legalnotice</tag> is found in the source. The
  8571. <tag>section</tag> contains the <tag>copyright</tag> contents followed
  8572. by the <tag>legalnotice</tag> contents. Closes
  8573. #1450209.</para>
  8574. <para role="commit-changes">Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 -
  8575. Michael(tm) Smith</para>
  8576. </listitem>
  8577. <listitem role="commit-message">
  8578. <para>Drastically reworked all of the
  8579. XPath expressions used in <tag>refentry</tag> metadata gathering
  8580. -- completely removed $parentinfo and turned $info into a set of
  8581. nodes that includes the *info contents of the <tag>Refentry</tag>
  8582. plus the *info contents all all of its ancestor elements. The
  8583. basic XPath expression now used throughout is (using the example
  8584. of checking for a <tag>date</tag>):</para>
  8585. <para>
  8586. (($info[//date])[last()]/date)[1].</para>
  8587. <para>That selects the "last"
  8588. *info/date <tag>date</tag> in document order -- that is, the one
  8589. eitther on the <tag>Refentry</tag> itself or on the
  8590. closest ancestor to the <tag>Refentry</tag>.</para>
  8591. <para>It's
  8592. likely this change may break some things; may need to pick up
  8593. some pieces later.</para>
  8594. <para>Also, changed the default value for the
  8595. <parameter>man.th.extra2.max.length</parameter> from 40 to
  8596. 30.</para>
  8597. <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
  8598. params/man.th.extra2.max.length.xml,1.2;
  8599. params/refentry.date.profile.xml,1.2;
  8600. params/refentry.manual.profile.xml,1.2;
  8601. params/refentry.source.name.profile.xml,1.2;
  8602. params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
  8603. manpages/other.xsl,1.15 - Michael(tm) Smith</para>
  8604. </listitem>
  8605. <listitem role="commit-message">
  8606. <para>Added support for DocBook 5
  8607. namespace-stripping in manpages stylesheet. Closes request
  8608. #1210692.</para>
  8609. <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
  8610. Michael(tm) Smith</para>
  8611. </listitem>
  8612. <listitem role="commit-message">
  8613. <para>Fixed handling of <tag>table</tag>
  8614. footnotes. With this checkin, the <tag>table</tag> support in the
  8615. manpages stylesheet is now basically feature complete. So this
  8616. change closes request #619532, "No support for tables" -- the
  8617. oldest currently open manpages feature request, submitted by Ben
  8618. Secrest (blsecres) on 2002-10-07. Congratulations to me [patting
  8619. myself on the back].</para>
  8620. <para role="commit-changes">Modified: manpages/block.xsl,1.11;
  8621. manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm)
  8622. Smith</para>
  8623. </listitem>
  8624. <listitem role="commit-message">
  8625. <para>Added handling for
  8626. <tag>table</tag> titles. Also fixed handling of nested tables;
  8627. nest tables are now "extracted" and displayed just after their
  8628. parent tables.</para>
  8629. <para role="commit-changes">Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14
  8630. - Michael(tm) Smith</para>
  8631. </listitem>
  8632. <listitem role="commit-message">
  8633. <para>Added option for turning off bold
  8634. formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
  8635. <tag>function</tag> <tag>synopsis</tag> is mandated in the
  8636. man(7) man page and is used almost universally in existing man
  8637. pages. Despite that, it really does look like crap to have an
  8638. entire <tag>Funcsynopsis</tag> output in bold, so I added params
  8639. for turning off the bold formatting and/or replacing it with a
  8640. different roff special font (e.g., "RI" for alternating
  8641. roman/italic instead of the default "BI" for alternating
  8642. bold/italic). The new params
  8643. are "man.<tag>funcprototype</tag>.font" and
  8644. "man.<tag>funcsynopsisinfo</tag>.font". To be documented
  8645. later.</para>
  8646. <para>Closes #1452247. Thanks to Joe Orton for the feature
  8647. request.</para>
  8648. <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
  8649. manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
  8650. manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
  8651. Smith</para>
  8652. </listitem>
  8653. <listitem role="commit-message">
  8654. <para>Use AUTHORS instead of
  8655. <tag>AUTHOR</tag> if we have multiple people to attribute. Also,
  8656. fixed checking such that we generate
  8657. <tag>author</tag> <tag>section</tag> even if we don't have an
  8658. <tag>author</tag> (as long as there is at least one other
  8659. person/entity we can put in the
  8660. <tag>section</tag>). Also adjusted assembly of content for
  8661. <tag>Author</tag> metainfo field such that we now not only use
  8662. <tag>author</tag>, but try to find a "best match" if we can't
  8663. find an <tag>author</tag> name to put there.</para>
  8664. <para>Closes
  8665. #1233592. Thanks to Sam Steingold for the
  8666. request.</para>
  8667. <para role="commit-changes">Modified: manpages/info.xsl,1.12 - Michael(tm)
  8668. Smith</para>
  8669. </listitem>
  8670. <listitem role="commit-message">
  8671. <para>Changes for request #1243027,
  8672. "Impove handling of <tag>AUTHOR</tag> <tag>section</tag>." This
  8673. adds support for <tag>Collab</tag>, Corpauthor, Corpcredt,
  8674. <tag>Orgname</tag>, <tag>Publishername</tag>, and
  8675. <tag>Publisher</tag>. Also adds support for output
  8676. of <tag>Affiliation</tag> and its children, and support for using
  8677. gentext strings for auto-attributing roles (<tag>Author</tag>,
  8678. <tag>Editor</tag>, <tag>Publisher</tag>, Translator, etc.). Also
  8679. did a lot of code cleanup and modularization of all the
  8680. <tag>AUTHOR</tag> handling code. And fixed a bug that was causing
  8681. <tag>Author</tag> <tag>info</tag> to not be picked up correctly
  8682. for metainfo comment we embed in man-page
  8683. source.</para>
  8684. <para role="commit-changes">Modified: manpages/info.xsl,1.11 - Michael(tm)
  8685. Smith</para>
  8686. </listitem>
  8687. <listitem role="commit-message">
  8688. <para>Support bold output for
  8689. "<tag>emphasis</tag> remap='B'". (because Eric Raymond's
  8690. doclifter(1) tool converts groff source marked up with ".B"
  8691. request or "\fB" escapes to DocBook "<tag>emphasis</tag>
  8692. remap='B'".)</para>
  8693. <para role="commit-changes">Modified: manpages/inline.xsl,1.14 - Michael(tm)
  8694. Smith</para>
  8695. </listitem>
  8696. <listitem role="commit-message">
  8697. <para>Added support for
  8698. <tag>Segmentedlist</tag>. Details: Output is tabular, with no
  8699. option for "list" type output. Output for <tag>Segtitle</tag>
  8700. elements can be supressed by
  8701. setting man.<tag>segtitle</tag>.suppress. If <tag>Segtitle</tag>
  8702. content is output, it is rendered in italic type (not bold
  8703. because not all terminals support bold and so italic ensures the
  8704. stand out on those terminals). Extra space (.sp line) at end of
  8705. <tag>table</tag> code ensures that it gets handled correctly in
  8706. the case where its source is the child of a <tag>Para</tag>.
  8707. Closes feature-request #1400097. Thanks to Daniel Leidert for the
  8708. patch and push, and to Alastair Rankine for filing the original
  8709. feature request.</para>
  8710. <para role="commit-changes">Modified: manpages/lists.xsl,1.23;
  8711. manpages/utility.xsl,1.10 - Michael(tm) Smith</para>
  8712. </listitem>
  8713. <listitem role="commit-message">
  8714. <para>Improved handling or
  8715. Author/Editor/Othercredit.</para>
  8716. <para>Reworked content of
  8717. (non-visible) comment added at top of each page (metadata
  8718. stuff).</para>
  8719. <para>Added support for generating a
  8720. <parameter>manifest</parameter> file (useful for cleaning up
  8721. after builds, etc.)</para>
  8722. <para role="commit-changes">Modified: manpages/docbook.xsl,1.46;
  8723. manpages/info.xsl,1.9; manpages/other.xsl,1.12;
  8724. manpages/utility.xsl,1.6 - Michael(tm) Smith</para>
  8725. </listitem>
  8726. <listitem role="commit-message">
  8727. <para>Added two new parameters for
  8728. handling of multi-term
  8729. <tag>varlistentry</tag> elements:</para>
  8730. <para><parameter>variablelist.term.break.after</parameter>:
  8731. When the <parameter>variablelist.term.break.after</parameter> is
  8732. non-zero, it will generate a line break after each
  8733. <tag>term</tag> multi-term
  8734. <tag>varlistentry</tag>.</para>
  8735. <para><parameter>variablelist.term.separator</parameter>:
  8736. When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
  8737. elements, the string specified in the value of the
  8738. <parameter>variablelist.term.separator</parameter> parameter is
  8739. placed after each <tag>term</tag> except the last. The default
  8740. is ", " (a comma followed by a space). To suppress rendering of
  8741. the separator, set the value of
  8742. <parameter>variablelist.term.separator</parameter> to the empty
  8743. string ("").</para>
  8744. <para>These parameters are primarily intended to be
  8745. useful if you have multi-term varlistentries that have long
  8746. terms.</para>
  8747. <para>Closes #1306676. Thanks to Sam Steingold for
  8748. providing an example "lots of long terms" doc that demonstrated
  8749. the value of having these options.</para>
  8750. <para>Also, added
  8751. normalize-space() call to processing of each
  8752. <tag>term</tag>.</para>
  8753. <para>This change affects all output formats
  8754. (HTML, PDF, manpages). The default behavior should pretty much
  8755. remain the same as before, but it is possible (as always) that
  8756. the change may introduce some
  8757. new bugginess.</para>
  8758. <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
  8759. fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
  8760. html/param.xweb,1.93; manpages/lists.xsl,1.22;
  8761. manpages/param.ent,1.14; manpages/param.xweb,1.16;
  8762. params/variablelist.term.break.after.xml,1.1;
  8763. params/variablelist.term.separator.xml,1.1 - Michael(tm)
  8764. Smith</para>
  8765. </listitem>
  8766. </itemizedlist>
  8767. </sect2><!--end of Manpages changes for snapshot_2006-05-15_0803-->
  8768. <sect2 xml:id="V1700_Params">
  8769. <title>Params</title>
  8770. <para>The following changes have been made to the
  8771. <filename>params</filename> code
  8772. since the 1.69.1 release.</para>
  8773. <itemizedlist>
  8774. <listitem role="commit-message">
  8775. <para>New parameters to set
  8776. header/footer <tag>table</tag> minimum
  8777. height.</para>
  8778. <para role="commit-changes">Modified: params/footer.table.height.xml,1.1;
  8779. params/header.table.height.xml,1.1 - Robert
  8780. Stayton</para>
  8781. </listitem>
  8782. <listitem role="commit-message">
  8783. <para>Support multiple indexing methods
  8784. for different languages.</para>
  8785. <para role="commit-changes">Modified: params/index.method.xml,1.1 - Robert
  8786. Stayton</para>
  8787. </listitem>
  8788. <listitem role="commit-message">
  8789. <para>Remove <tag>qandaset</tag> and
  8790. <tag>qandadiv</tag> from <parameter>generate.toc</parameter> for fo
  8791. output because formerly it wasn't working, but now it is and
  8792. the default behavior should stay the
  8793. same.</para>
  8794. <para role="commit-changes">Modified: params/generate.toc.xml,1.8 - Robert
  8795. Stayton</para>
  8796. </listitem>
  8797. <listitem role="commit-message">
  8798. <para>add support for page number
  8799. references to <tag>link</tag> element
  8800. too.</para>
  8801. <para role="commit-changes">Modified: params/insert.link.page.number.xml,1.1 - Robert
  8802. Stayton</para>
  8803. </listitem>
  8804. <listitem role="commit-message">
  8805. <para>Add support for more characters to
  8806. hyphen on when <parameter>ulink.hyphenate</parameter> is turned
  8807. on.</para>
  8808. <para role="commit-changes">Modified: params/ulink.hyphenate.chars.xml,1.1;
  8809. params/ulink.hyphenate.xml,1.3 - Robert Stayton</para>
  8810. </listitem>
  8811. <listitem role="commit-message">
  8812. <para>New attribute-set to format
  8813. <tag>biblioentry</tag> and
  8814. <tag>bibliomixed</tag>.</para>
  8815. <para role="commit-changes">Modified: params/biblioentry.properties.xml,1.1 -
  8816. Robert Stayton</para>
  8817. </listitem>
  8818. <listitem role="commit-message">
  8819. <para>Added new parameter
  8820. <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
  8821. controls presence of <tag>title</tag> in a separate chunk with
  8822. ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
  8823. generating frameset output (well, yes those frames, but some customers
  8824. really want them ;-).</para>
  8825. <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
  8826. html/param.ent,1.93; html/param.xweb,1.102;
  8827. params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
  8828. Kosek</para>
  8829. </listitem>
  8830. <listitem role="commit-message">
  8831. <para>Added new attribute set
  8832. <tag>toc</tag>.line.properties for controlling appearance of lines in
  8833. ToC/LoT</para>
  8834. <para role="commit-changes">Modified: params/toc.line.properties.xml,1.1 - Jirka
  8835. Kosek</para>
  8836. </listitem>
  8837. <listitem role="commit-message">
  8838. <para>Allow <tag>table</tag> footnotes
  8839. to have different properties from regular
  8840. footnotes.</para>
  8841. <para role="commit-changes">Modified: params/table.footnote.properties.xml,1.1 - Robert
  8842. Stayton</para>
  8843. </listitem>
  8844. <listitem role="commit-message">
  8845. <para>Set properties for pgwide="1"
  8846. objects.</para>
  8847. <para role="commit-changes">Modified: params/pgwide.properties.xml,1.1 - Robert
  8848. Stayton</para>
  8849. </listitem>
  8850. <listitem role="commit-message">
  8851. <para>Added the
  8852. autotoc.<tag>label</tag>.in.hyperlink param.</para>
  8853. <para>If the value
  8854. of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
  8855. are included in hyperlinked titles in the <tag>TOC</tag>. If it
  8856. is instead zero, labels are still displayed prior to the
  8857. hyperlinked titles, but are not hyperlinked along with the
  8858. titles.</para>
  8859. <para>Closes patch #1065868. Thanks to anatoly techtonik
  8860. for the patch.</para>
  8861. <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
  8862. html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
  8863. Michael(tm) Smith</para>
  8864. </listitem>
  8865. <listitem role="commit-message">
  8866. <para>Added two new params:
  8867. html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
  8868. and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
  8869. <para>If
  8870. the value of the <parameter>generate.legalnotice.link</parameter> is
  8871. non-zero, then the stylesheet generates (in the head
  8872. <tag>section</tag> of the HTML source) either a single HTML
  8873. <tag>link</tag> element or, if the value of
  8874. the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
  8875. non-zero, one <tag>link</tag> element for each <tag>link</tag>
  8876. type specified. Each <tag>link</tag> has the
  8877. following attributes:</para>
  8878. <para> - a rel attribute whose value
  8879. is derived from the value of
  8880. html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
  8881. <para> -
  8882. an href attribute whose value is set to the URL of the file
  8883. containing the <tag>legalnotice</tag></para>
  8884. <para> - a <tag>title</tag>
  8885. attribute whose value is set to the <tag>title</tag> of the
  8886. corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
  8887. programatically determined by the stylesheet)</para>
  8888. <para>For
  8889. example:</para>
  8890. <para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
  8891. href="ln-id2524073.html" title="Legal Notice"&gt;</para>
  8892. <para>Closes
  8893. #1476450. Thanks to Sam Steingold.</para>
  8894. <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
  8895. html/param.ent,1.91; html/param.xweb,1.100;
  8896. params/generate.legalnotice.link.xml,1.4;
  8897. params/html.head.legalnotice.link.multiple.xml,1.1;
  8898. params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
  8899. Smith</para>
  8900. </listitem>
  8901. <listitem role="commit-message">
  8902. <para>Added the following
  8903. params:</para>
  8904. <para> - man.indent.width (string-valued) -
  8905. man.indent.refsect (boolean) - man.indent.blurbs (boolean)
  8906. - man.indent.lists (boolean) - man.indent.verbatims
  8907. (boolean)</para>
  8908. <para>Note that in earlier snapshots, man.indent.width
  8909. was named man.indentation.default.value and the boolean params
  8910. had names like man.indentation.*.adjust. Also the
  8911. man.indent.blurbs param was called man.indentation.authors.adjust
  8912. (or something).</para>
  8913. <para>The behavior now is: If the value of a
  8914. particular man.indent.* boolean param is non-zero, the
  8915. corresponding contents (refsect*, list items,
  8916. authorblurb/personblurb, vervatims) are displayed with a left
  8917. margin indented by a width equal to the value
  8918. of man.indent.width.</para>
  8919. <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
  8920. manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
  8921. manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
  8922. manpages/param.ent,1.22; manpages/param.xweb,1.24;
  8923. manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
  8924. params/man.indent.refsect.xml,1.1;
  8925. params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
  8926. Michael(tm) Smith</para>
  8927. </listitem>
  8928. <listitem role="commit-message">
  8929. <para>Added
  8930. man.<tag>table</tag>.footnotes.divider param.</para>
  8931. <para>In each
  8932. <tag>table</tag> that contains footenotes, the string specified
  8933. by the man.<tag>table</tag>.footnotes.divider parameter is output
  8934. before the list of footnotes for the
  8935. <tag>table</tag>.</para>
  8936. <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
  8937. manpages/links.xsl,1.6; manpages/param.ent,1.21;
  8938. manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
  8939. Michael(tm) Smith</para>
  8940. </listitem>
  8941. <listitem role="commit-message">
  8942. <para>Added the
  8943. man.output.in.separate.dir,
  8944. man.output.<parameter>base.dir</parameter>,
  8945. and man.output.subdirs.enabled parameters.</para>
  8946. <para>The
  8947. man.output.<parameter>base.dir</parameter> parameter specifies the
  8948. base directory into which man-page files are
  8949. output. The man.output.subdirs.enabled parameter controls whether
  8950. the files are output in subdirectories within the base
  8951. directory.</para>
  8952. <para>The values of the
  8953. man.output.<parameter>base.dir</parameter>
  8954. and man.output.subdirs.enabled parameters are used only if the
  8955. value of man.output.in.separate.dir parameter is non-zero. If the
  8956. value of man.output.in.separate.dir is zero, man-page files are
  8957. not output in a separate
  8958. directory.</para>
  8959. <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
  8960. manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
  8961. params/man.output.in.separate.dir.xml,1.1;
  8962. params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
  8963. Smith</para>
  8964. </listitem>
  8965. <listitem role="commit-message">
  8966. <para>Added
  8967. man.font.<tag>table</tag>.headings and
  8968. man.font.<tag>table</tag>.<tag>title</tag> params, for
  8969. controlling font in <tag>table</tag> headings and
  8970. titles.</para>
  8971. <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
  8972. manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
  8973. params/man.font.table.title.xml,1.1 - Michael(tm)
  8974. Smith</para>
  8975. </listitem>
  8976. <listitem role="commit-message">
  8977. <para>Added
  8978. man.font.<tag>funcsynopsisinfo</tag> and
  8979. man.font.<tag>funcprototype</tag> params, for specifying the roff
  8980. font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
  8981. <tag>funcprototype</tag> output.</para>
  8982. <para role="commit-changes">Modified: manpages/block.xsl,1.19;
  8983. manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
  8984. manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
  8985. manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
  8986. params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
  8987. Smith</para>
  8988. </listitem>
  8989. <listitem role="commit-message">
  8990. <para>Changed to select="0" in
  8991. <tag>refclass</tag>.suppress (instead of
  8992. ..&gt;0&lt;/..)</para>
  8993. <para role="commit-changes">Modified: params/refclass.suppress.xml,1.3 - Michael(tm)
  8994. Smith</para>
  8995. </listitem>
  8996. <listitem role="commit-message">
  8997. <para>Added
  8998. man.<tag>segtitle</tag>.suppress param.</para>
  8999. <para>If the value of
  9000. man.<tag>segtitle</tag>.suppress is non-zero, then display
  9001. of <tag>segtitle</tag> contents is suppressed in
  9002. output.</para>
  9003. <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
  9004. manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
  9005. Michael(tm) Smith</para>
  9006. </listitem>
  9007. <listitem role="commit-message">
  9008. <para>Added
  9009. man.output.<parameter>manifest</parameter>.enabled and
  9010. man.output.manifest.<tag>filename</tag> params.</para>
  9011. <para>If
  9012. man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
  9013. of filenames for man pages generated by the stylesheet
  9014. transformation is written to the file named by
  9015. man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
  9016. <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
  9017. manpages/other.xsl,1.19; manpages/param.ent,1.16;
  9018. manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
  9019. params/man.output.manifest.filename.xml,1.1;
  9020. tools/make/Makefile.DocBook,1.4 - Michael(tm)
  9021. Smith</para>
  9022. </listitem>
  9023. <listitem role="commit-message">
  9024. <para>Added <tag>refclass</tag>.suppress
  9025. param.</para>
  9026. <para>If the value of <tag>refclass</tag>.suppress is
  9027. non-zero, then display <tag>refclass</tag> contents is suppressed
  9028. in output. Affects HTML and FO output
  9029. only.</para>
  9030. <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
  9031. html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
  9032. Smith</para>
  9033. </listitem>
  9034. <listitem role="commit-message">
  9035. <para>Added
  9036. <tag>refentry</tag>.meta.get.quietly param.</para>
  9037. <para>If zero (the
  9038. default), notes and warnings about "missing" markup are generated
  9039. during gathering of <tag>refentry</tag> metadata. If
  9040. non-zero, the metadata is gathered "quietly" -- that is, the
  9041. notes and warnings are suppressed.</para>
  9042. <para>NOTE: If you are
  9043. processing a large amount of <tag>refentry</tag> content, you
  9044. may be able to speed up processing significantly by setting a
  9045. non-zero value for
  9046. <tag>refentry</tag>.meta.get.quietly.</para>
  9047. <para role="commit-changes">Modified: common/refentry.xsl,1.17;
  9048. manpages/param.ent,1.15; manpages/param.xweb,1.17;
  9049. params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
  9050. Smith</para>
  9051. </listitem>
  9052. <listitem role="commit-message">
  9053. <para>Added support for "software" and
  9054. "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
  9055. treated identically to "source", and "setdesc" is treated
  9056. identically to "manual".</para>
  9057. <para role="commit-changes">Modified: common/refentry.xsl,1.10;
  9058. params/man.th.extra2.max.length.xml,1.3;
  9059. params/refentry.source.name.profile.xml,1.4 - Michael(tm)
  9060. Smith</para>
  9061. </listitem>
  9062. <listitem role="commit-message">
  9063. <para>Drastically reworked all of the
  9064. XPath expressions used in <tag>refentry</tag> metadata gathering
  9065. -- completely removed $parentinfo and turned $info into a set of
  9066. nodes that includes the *info contents of the <tag>Refentry</tag>
  9067. plus the *info contents all all of its ancestor elements. The
  9068. basic XPath expression now used throughout is (using the example
  9069. of checking for a <tag>date</tag>):</para>
  9070. <para>
  9071. (($info[//date])[last()]/date)[1].</para>
  9072. <para>That selects the "last"
  9073. *info/date <tag>date</tag> in document order -- that is, the one
  9074. eitther on the <tag>Refentry</tag> itself or on the
  9075. closest ancestor to the <tag>Refentry</tag>.</para>
  9076. <para>It's
  9077. likely this change may break some things; may need to pick up
  9078. some pieces later.</para>
  9079. <para>Also, changed the default value for the
  9080. <parameter>man.th.extra2.max.length</parameter> from 40 to
  9081. 30.</para>
  9082. <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
  9083. params/man.th.extra2.max.length.xml,1.2;
  9084. params/refentry.date.profile.xml,1.2;
  9085. params/refentry.manual.profile.xml,1.2;
  9086. params/refentry.source.name.profile.xml,1.2;
  9087. params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
  9088. manpages/other.xsl,1.15 - Michael(tm) Smith</para>
  9089. </listitem>
  9090. <listitem role="commit-message">
  9091. <para>Added option for turning off bold
  9092. formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
  9093. <tag>function</tag> <tag>synopsis</tag> is mandated in the
  9094. man(7) man page and is used almost universally in existing man
  9095. pages. Despite that, it really does look like crap to have an
  9096. entire <tag>Funcsynopsis</tag> output in bold, so I added params
  9097. for turning off the bold formatting and/or replacing it with a
  9098. different roff special font (e.g., "RI" for alternating
  9099. roman/italic instead of the default "BI" for alternating
  9100. bold/italic). The new params
  9101. are "man.<tag>funcprototype</tag>.font" and
  9102. "man.<tag>funcsynopsisinfo</tag>.font". To be documented
  9103. later.</para>
  9104. <para>Closes #1452247. Thanks to Joe Orton for the feature
  9105. request.</para>
  9106. <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
  9107. manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
  9108. manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
  9109. Smith</para>
  9110. </listitem>
  9111. <listitem role="commit-message">
  9112. <para><parameter>fop.extensions</parameter> now only
  9113. for FOP version 0.20.5 and earlier.</para>
  9114. <para role="commit-changes">Modified: params/fop.extensions.xml,1.4
  9115. - Robert Stayton</para>
  9116. </listitem>
  9117. <listitem role="commit-message">
  9118. <para>Support for fop1 different from
  9119. fop 0.20.5 and earlier.</para>
  9120. <para role="commit-changes">Modified: params/fop1.extensions.xml,1.1 - Robert
  9121. Stayton</para>
  9122. </listitem>
  9123. <listitem role="commit-message">
  9124. <para>Reset default value to empty
  9125. string so template uses gentext first, then the parameter value
  9126. if not empty.</para>
  9127. <para role="commit-changes">Modified: params/index.number.separator.xml,1.2;
  9128. params/index.range.separator.xml,1.2;
  9129. params/index.term.separator.xml,1.2 - Robert
  9130. Stayton</para>
  9131. </listitem>
  9132. <listitem role="commit-message">
  9133. <para>New parameter:
  9134. <parameter>id.warnings</parameter>. If non-zero, warnings are
  9135. generated for titled objects that don't have titles. True by default;
  9136. I wonder if this will be too aggressive?</para>
  9137. <para role="commit-changes">Modified: html/biblio.xsl,1.25;
  9138. html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
  9139. html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
  9140. html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
  9141. html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
  9142. Walsh</para>
  9143. </listitem>
  9144. <listitem role="commit-message">
  9145. <para>Added new parameter
  9146. <parameter>keep.relative.image.uris</parameter></para>
  9147. <para role="commit-changes">Modified: fo/param.ent,1.91;
  9148. fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
  9149. params/keep.relative.image.uris.xml,1.1 - Norman
  9150. Walsh</para>
  9151. </listitem>
  9152. <listitem role="commit-message">
  9153. <para>Support default <tag>label</tag>
  9154. width parameters for itemized and ordered lists</para>
  9155. <para role="commit-changes">Modified: fo/lists.xsl,1.64;
  9156. fo/param.ent,1.90; fo/param.xweb,1.103;
  9157. params/itemizedlist.label.width.xml,1.1;
  9158. params/orderedlist.label.width.xml,1.1 - Norman
  9159. Walsh</para>
  9160. </listitem>
  9161. <listitem role="commit-message">
  9162. <para>Added parameters to localize
  9163. punctuation in indexes.</para>
  9164. <para role="commit-changes">Modified: params/index.number.separator.xml,1.1;
  9165. params/index.range.separator.xml,1.1;
  9166. params/index.term.separator.xml,1.1 - Robert
  9167. Stayton</para>
  9168. </listitem>
  9169. <listitem role="commit-message">
  9170. <para>Added two new parameters for
  9171. handling of multi-term
  9172. <tag>varlistentry</tag> elements:</para>
  9173. <para><parameter>variablelist.term.break.after</parameter>:
  9174. When the <parameter>variablelist.term.break.after</parameter> is
  9175. non-zero, it will generate a line break after each
  9176. <tag>term</tag> multi-term
  9177. <tag>varlistentry</tag>.</para>
  9178. <para><parameter>variablelist.term.separator</parameter>:
  9179. When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
  9180. elements, the string specified in the value of the
  9181. <parameter>variablelist.term.separator</parameter> parameter is
  9182. placed after each <tag>term</tag> except the last. The default
  9183. is ", " (a comma followed by a space). To suppress rendering of
  9184. the separator, set the value of
  9185. <parameter>variablelist.term.separator</parameter> to the empty
  9186. string ("").</para>
  9187. <para>These parameters are primarily intended to be
  9188. useful if you have multi-term varlistentries that have long
  9189. terms.</para>
  9190. <para>Closes #1306676. Thanks to Sam Steingold for
  9191. providing an example "lots of long terms" doc that demonstrated
  9192. the value of having these options.</para>
  9193. <para>Also, added
  9194. normalize-space() call to processing of each
  9195. <tag>term</tag>.</para>
  9196. <para>This change affects all output formats
  9197. (HTML, PDF, manpages). The default behavior should pretty much
  9198. remain the same as before, but it is possible (as always) that
  9199. the change may introduce some
  9200. new bugginess.</para>
  9201. <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
  9202. fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
  9203. html/param.xweb,1.93; manpages/lists.xsl,1.22;
  9204. manpages/param.ent,1.14; manpages/param.xweb,1.16;
  9205. params/variablelist.term.break.after.xml,1.1;
  9206. params/variablelist.term.separator.xml,1.1 - Michael(tm)
  9207. Smith</para>
  9208. </listitem>
  9209. <listitem role="commit-message">
  9210. <para>Convert 'no' to string in default
  9211. value.</para>
  9212. <para role="commit-changes">Modified: params/olink.doctitle.xml,1.4 - Robert
  9213. Stayton</para>
  9214. </listitem>
  9215. <listitem role="commit-message">
  9216. <para>Implemented RFE
  9217. #1292615.</para>
  9218. <para>Added bunch of new parameters (attribute sets)
  9219. that affect list presentation: list.block.properties,
  9220. <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
  9221. <tag>itemizedlist</tag>.<tag>label</tag>.properties and
  9222. <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
  9223. of stylesheets has not been changed but further customizations will be
  9224. much more easier.</para>
  9225. <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
  9226. fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
  9227. params/itemizedlist.properties.xml,1.1;
  9228. params/list.block.properties.xml,1.1;
  9229. params/orderedlist.label.properties.xml,1.1;
  9230. params/orderedlist.properties.xml,1.1 - Jirka
  9231. Kosek</para>
  9232. </listitem>
  9233. <listitem role="commit-message">
  9234. <para>Implemented RFE
  9235. #1242092.</para>
  9236. <para>You can enable crop marks in your document by
  9237. setting crop.marks=1 and xep.extensions=1. Appearance of crop
  9238. marks can be controlled by parameters
  9239. <parameter>crop.mark.bleed</parameter> (6pt),
  9240. <parameter>crop.mark.offset</parameter> (24pt) and
  9241. <parameter>crop.mark.width</parameter> (0.5pt).</para>
  9242. <para>Also there
  9243. is new named template called user-xep-pis. You can overwrite it in
  9244. order to produce some PIs that can control XEP as described in
  9245. http://www.renderx.com/reference.html#Output_Formats</para>
  9246. <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
  9247. fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
  9248. params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
  9249. params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
  9250. Kosek</para>
  9251. </listitem>
  9252. <listitem role="commit-message">
  9253. <para>Changed short descriptions in doc
  9254. for *autolabel* params to match new autolabel
  9255. behavior.</para>
  9256. <para role="commit-changes">Modified: params/appendix.autolabel.xml,1.5;
  9257. params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5;
  9258. params/preface.autolabel.xml,1.4 - Michael(tm)
  9259. Smith</para>
  9260. </listitem>
  9261. </itemizedlist>
  9262. </sect2><!--end of Params changes for snapshot_2006-05-15_0803-->
  9263. <sect2 xml:id="V1700_Profiling">
  9264. <title>Profiling</title>
  9265. <para>The following changes have been made to the
  9266. <filename>profiling</filename> code
  9267. since the 1.69.1 release.</para>
  9268. <itemizedlist>
  9269. <listitem role="commit-message">
  9270. <para>Profiling now works together with
  9271. namespace stripping (V5 documents). Namespace striping should work
  9272. with all stylesheets named profile-, even if they are not supporting
  9273. namespace stripping in a non-profiling
  9274. variant.</para>
  9275. <para role="commit-changes">Modified: profiling/profile-mode.xsl,1.4;
  9276. profiling/xsl2profile.xsl,1.7 - Jirka Kosek</para>
  9277. </listitem>
  9278. <listitem role="commit-message">
  9279. <para>Moved profiling stage out of
  9280. templates. This make possible to reuse profiled content by several
  9281. templates and still maintaing node indentity (needed for example for
  9282. HTML Help where content is processed multiple times).</para>
  9283. <para>I
  9284. don't know why this was not on the top level before. Maybe some XSLT
  9285. processors choked on it. I hope this will be OK
  9286. now.</para>
  9287. <para role="commit-changes">Modified: profiling/xsl2profile.xsl,1.5 - Jirka
  9288. Kosek</para>
  9289. </listitem>
  9290. </itemizedlist>
  9291. </sect2><!--end of Profiling changes for snapshot_2006-05-15_0803-->
  9292. <sect2 xml:id="V1700_Tools">
  9293. <title>Tools</title>
  9294. <para>The following changes have been made to the
  9295. <filename>tools</filename> code
  9296. since the 1.69.1 release.</para>
  9297. <itemizedlist>
  9298. <listitem role="commit-message">
  9299. <para>Moved Makefile.DocBook from
  9300. <tag>contrib</tag> module to xsl
  9301. module.</para>
  9302. <para role="commit-changes">Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm)
  9303. Smith</para>
  9304. </listitem>
  9305. </itemizedlist>
  9306. </sect2><!--end of Tools changes for snapshot_2006-05-15_0803-->
  9307. <sect2 xml:id="V1700_WordML">
  9308. <title>WordML</title>
  9309. <para>The following changes have been made to the
  9310. <filename>wordml</filename> code
  9311. since the 1.69.1 release.</para>
  9312. <itemizedlist>
  9313. <listitem role="commit-message">
  9314. <para>added <tag>contrib</tag> element,
  9315. better handling of default paragraph
  9316. style</para>
  9317. <para role="commit-changes">Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2;
  9318. wordml/wordml-final.xsl,1.14 - Steve Ball</para>
  9319. </listitem>
  9320. <listitem role="commit-message">
  9321. <para>added
  9322. <tag>bridgehead</tag></para>
  9323. <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.6;
  9324. wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5;
  9325. wordml/template-pages.xml,1.7; wordml/template.dot,1.4;
  9326. wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve
  9327. Ball</para>
  9328. </listitem>
  9329. <listitem role="commit-message">
  9330. <para>added blocks stylesheet to support
  9331. bibliographies, glossaries and qandasets</para>
  9332. <para role="commit-changes">Modified: wordml/Makefile,1.4;
  9333. wordml/README,1.3; wordml/blocks-spec.xml,1.1;
  9334. wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
  9335. wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3;
  9336. wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6;
  9337. wordml/template.dot,1.3; wordml/template.xml,1.13;
  9338. wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12;
  9339. wordml/wordml-sections.xsl,1.3 - Steve Ball</para>
  9340. </listitem>
  9341. <listitem role="commit-message">
  9342. <para>added <tag>mediaobject</tag>
  9343. <tag>caption</tag></para>
  9344. <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.4;
  9345. wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12;
  9346. wordml/template-pages.xml,1.5; wordml/template.dot,1.2;
  9347. wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve
  9348. Ball</para>
  9349. </listitem>
  9350. <listitem role="commit-message">
  9351. <para>added
  9352. callouts</para>
  9353. <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14;
  9354. wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11;
  9355. wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve
  9356. Ball</para>
  9357. </listitem>
  9358. <listitem role="commit-message">
  9359. <para>added Word template
  9360. file</para>
  9361. <para role="commit-changes">Modified: wordml/template.dot,1.1 - Steve Ball</para>
  9362. </listitem>
  9363. <listitem role="commit-message">
  9364. <para>added <tag>abstract</tag>, fixed
  9365. <tag>itemizedlist</tag>, ulink</para>
  9366. <para role="commit-changes">Modified: wordml/specifications.xml,1.10;
  9367. wordml/wordml-final.xsl,1.9 - Steve Ball</para>
  9368. </listitem>
  9369. <listitem role="commit-message">
  9370. <para>fixed Makefile added many
  9371. features to Pages support added <tag>revhistory</tag>, inlines,
  9372. highlights, <tag>abstract</tag></para>
  9373. <para role="commit-changes">Modified: wordml/Makefile,1.2;
  9374. wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2;
  9375. wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9;
  9376. wordml/template-pages.xml,1.3; wordml/template.xml,1.11;
  9377. wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve
  9378. Ball</para>
  9379. </listitem>
  9380. <listitem role="commit-message">
  9381. <para>fixed handling linebreaks when
  9382. generating WordML added Apple Pages
  9383. support</para>
  9384. <para role="commit-changes">Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 -
  9385. Steve Ball</para>
  9386. </listitem>
  9387. </itemizedlist>
  9388. </sect2><!--end of WordML changes for snapshot_2006-05-15_0803-->
  9389. </sect1>
  9390. <sect1 xml:id="V1691">
  9391. <title>Release 1.69.1</title>
  9392. <para>This release is a minor bug-fix update to the 1.69.0
  9393. release. Along with bug fixes, it includes one
  9394. configuration-parameter change: The default value of the
  9395. <parameter>annotation.support</parameter> parameter is now
  9396. <literal>0</literal> (off). The reason for that change is that
  9397. there have been reports that <tag>annotation</tag> handling is
  9398. causing a significant performance degradation in processing of
  9399. large documents with <command>xsltproc</command>.</para>
  9400. </sect1>
  9401. <!-- end of notes for 1.69.1 release -->
  9402. <sect1 xml:id="V1690">
  9403. <title>Release 1.69.0</title>
  9404. <para>The release includes major feature changes,
  9405. particularly in the <link linkend="V1690_MAN">manpages
  9406. stylesheets</link>, as well as a large number of bug fixes.</para>
  9407. <para>As with all DocBook Project <quote>dot zero</quote> releases, this is an
  9408. <link linkend="dot0">experimental release </link>.</para>
  9409. <sect2 xml:id="V1690_COMMON">
  9410. <title>Common</title>
  9411. <itemizedlist>
  9412. <listitem>
  9413. <para>This release adds localizations for the following
  9414. languages:
  9415. <simplelist type="inline">
  9416. <?dbchoice choice="and"?>
  9417. <member>Albanian</member>
  9418. <member>Amharic</member>
  9419. <member>Azerbaijani</member>
  9420. <member>Hindi</member>
  9421. <member>Irish (Gaelic)</member>
  9422. <member>Gujarati</member>
  9423. <member>Kannada</member>
  9424. <member>Mongolian</member>
  9425. <member>Oriya</member>
  9426. <member>Punjabi</member>
  9427. <member>Tagalog</member>
  9428. <member>Tamil</member>
  9429. <member>Welsh</member>
  9430. </simplelist>.</para>
  9431. </listitem>
  9432. <listitem>
  9433. <para>Added support for specifying number format for auto
  9434. labels for <tag>chapter</tag>, <tag>appendix</tag>,
  9435. <tag>part</tag>, and <tag>preface</tag>. Contolled with the
  9436. <parameter>appendix.autolabel</parameter>,
  9437. <parameter>chapter.autolabel</parameter>,
  9438. <parameter>part.autolabel</parameter>, and
  9439. <parameter>preface.autolabel</parameter> parameters.</para>
  9440. </listitem>
  9441. <listitem>
  9442. <para>Added basic support for <tag>biblioref</tag> cross
  9443. referencing.</para>
  9444. </listitem>
  9445. <listitem>
  9446. <para>Added support for <tag class="attribute">align</tag>
  9447. on <tag>caption</tag> in <tag>mediaobject</tag>.</para>
  9448. </listitem>
  9449. <listitem>
  9450. <para>Added support for processing documents that use the
  9451. DocBook V5 namespace.</para>
  9452. </listitem>
  9453. <listitem>
  9454. <para>Added support for <tag>termdef</tag> and
  9455. <tag>mathphrase</tag>.</para>
  9456. </listitem>
  9457. <listitem>
  9458. <para>EXPERIMENTAL: Incorporated the Slides and Website
  9459. stylesheets into the DocBook XSL stylesheets package. So,
  9460. for example, Website documents can now be processed using
  9461. the following URI for the driver Website
  9462. <filename>tabular.xsl</filename> file: <literallayout class="monospaced"><uri>http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</uri></literallayout></para>
  9463. </listitem>
  9464. <listitem>
  9465. <para>A <tag>procedure</tag> without a <tag>title</tag> is
  9466. now treated as an <quote>informal</quote> procedure (meaning
  9467. that it is not added to any generated <quote>list of
  9468. procedures</quote> and has no affect on numbering of
  9469. generated labels for other procedures).</para>
  9470. </listitem>
  9471. <listitem>
  9472. <para><tag>docname</tag> is no longer added to
  9473. <tag>olink</tag> when pointing to a root element.</para>
  9474. </listitem>
  9475. <!-- ======================================================= -->
  9476. <listitem>
  9477. <para>Added support for generation of choice separator in
  9478. inline simplelist. This enables auto-generation of an
  9479. appropriate localized <quote>choice separator</quote> (for
  9480. example, <quote>and</quote> or <quote>or</quote>) before the
  9481. final item in an inline <tag>simplelist</tag>.</para>
  9482. <para>To indicate that you want a choice separator
  9483. generated for a particular list, you need to put a processing
  9484. instruction (PI) of the form
  9485. <tag class="xmlpi">dbchoice&#xA0;choice="foo"</tag> as a
  9486. child of the list. For example:
  9487. <literallayout class="monospaced"> &lt;para&gt;Choose from
  9488. ONE and ONLY ONE of the following:
  9489. &lt;simplelist type="inline"&gt;
  9490. &lt;?dbchoice choice="or" ?&gt;
  9491. &lt;member&gt;A&lt;/member&gt;
  9492. &lt;member&gt;B&lt;/member&gt;
  9493. &lt;member&gt;C&lt;/member&gt;.&lt;/simplelist&gt;&lt;/para&gt;</literallayout>
  9494. Output (for English):
  9495. <blockquote>
  9496. <para>Choose from ONE and only ONE of the
  9497. following choices: A, B, or C.</para>
  9498. </blockquote>
  9499. As a temporary workaround for the fact that most of the
  9500. DocBook non-English locale files don't have a localization for
  9501. the word <quote>or</quote>, you can put in a literal string to
  9502. be used; example for French: <tag class="pi">dbchoice&#xA0;choice="ou"</tag>. That is, use
  9503. <quote>ou</quote> instead of <quote>or</quote>.</para>
  9504. </listitem>
  9505. </itemizedlist>
  9506. </sect2>
  9507. <sect2 xml:id="V1690_FO">
  9508. <title>FO</title>
  9509. <itemizedlist>
  9510. <listitem>
  9511. <para> Added <literal>content-type</literal> property to
  9512. <literal>external-graphic</literal> element, based on
  9513. <tag>imagedata</tag> <tag class="attribute">format</tag>
  9514. attribute.</para>
  9515. </listitem>
  9516. <listitem>
  9517. <para>Added support for generating
  9518. <literal>&lt;rx:meta-field&#xA0;creator="$VERSION"/&gt;</literal>
  9519. field for XEP output. This makes the DocBook XSL
  9520. stylesheet version information available through the
  9521. <guimenu>Document Properties</guimenu> menu in Acrobat
  9522. Reader and other PDF viewers.</para>
  9523. </listitem>
  9524. <listitem>
  9525. <para>Trademark symbol handling made consistent with
  9526. handling of same in HTML stylesheets. Prior to this change,
  9527. if you processed a document that contained no value for the
  9528. <tag class="attribute">class</tag> attribute on the
  9529. <tag>trademark</tag> element, the HTML stylesheets would
  9530. default to rendering a superscript <literal>TM
  9531. </literal>symbol after the <tag>trademark</tag> contents,
  9532. but the FO stylesheets would render nothing.</para>
  9533. </listitem>
  9534. <listitem>
  9535. <para>Added support for generating XEP bookmarks for
  9536. <tag>refentry</tag>.</para>
  9537. </listitem>
  9538. <listitem>
  9539. <para>Added support for HTML markup <tag>table</tag> <tag class="attribute">border</tag> attribute, applied to each
  9540. table cell.</para>
  9541. </listitem>
  9542. <listitem>
  9543. <para>The <function>table.width</function> template can now
  9544. sum column specs if none use <literal>%</literal> or
  9545. <literal>*</literal>.</para>
  9546. </listitem>
  9547. <listitem>
  9548. <para>Added <literal>fox:destination</literal> extension
  9549. inside <literal>fox:outline</literal> to support linking to
  9550. internal destinations.</para>
  9551. </listitem>
  9552. <listitem>
  9553. <para>Added support for customizing
  9554. <literal>abstract</literal> with property sets. Controlled
  9555. with the <parameter>abstract.properties</parameter> and
  9556. <parameter>abstract.title.properties</parameter>
  9557. parameters.</para>
  9558. </listitem>
  9559. <listitem>
  9560. <para>Add <tag>footnote</tag>s in <tag>table</tag> title to
  9561. table footnote set, and add support for table footnotes to
  9562. HTML table markup.</para>
  9563. </listitem>
  9564. <listitem>
  9565. <para>Added support for <tag>title</tag> in
  9566. <tag>glosslist</tag>.</para>
  9567. </listitem>
  9568. <listitem>
  9569. <para>Added support for <tag>itemizedlist</tag> symbol
  9570. <literal>none</literal>.</para>
  9571. </listitem>
  9572. <listitem>
  9573. <para>Implemented the new
  9574. <parameter>graphical.admonition.properties</parameter> and
  9575. <parameter>nongraphical.admonition.properties</parameter>
  9576. attribute sets.</para>
  9577. </listitem>
  9578. <listitem>
  9579. <para>Added <tag class="attribute">id</tag> to
  9580. <tag>formalpara</tag> and some other blocks that were
  9581. missing it.</para>
  9582. </listitem>
  9583. <listitem>
  9584. <para>Changed the anchor template to output
  9585. <literal>fo:inline</literal> instead of
  9586. <literal>fo:wrapper</literal>.</para>
  9587. </listitem>
  9588. <listitem>
  9589. <para>Added support for <parameter>toc.max.depth</parameter>
  9590. parameter.</para>
  9591. </listitem>
  9592. </itemizedlist>
  9593. </sect2>
  9594. <sect2 xml:id="V1690_HELP">
  9595. <title>Help</title>
  9596. <itemizedlist>
  9597. <listitem>
  9598. <para>Eclipse Help: Added support for generating olink
  9599. database.</para>
  9600. </listitem>
  9601. </itemizedlist>
  9602. </sect2>
  9603. <sect2 xml:id="V1690_HTML">
  9604. <title>HTML</title>
  9605. <itemizedlist>
  9606. <listitem>
  9607. <para>Added a first cut at support in HTML output for
  9608. DocBook 5 style <tag>annotation</tag>s. Controlled using the
  9609. <parameter>annotation.support</parameter> parameter, and
  9610. implemented using JavaScript and CSS styling. For more
  9611. details, see the documentation for the
  9612. <parameter>annotation.js</parameter>,
  9613. <parameter>annotation.css</parameter>,
  9614. <parameter>annotation.graphic.open</parameter>, and
  9615. <parameter>annotation.graphic.close</parameter>
  9616. parameters.</para>
  9617. </listitem>
  9618. <listitem>
  9619. <para>Generate client-side image map for
  9620. <tag>imageobjectco</tag> with areas using
  9621. <literal>calspair</literal> units</para>
  9622. </listitem>
  9623. <listitem>
  9624. <para>Added support for <tag class="xmlpi">img.src.path</tag> PI.</para>
  9625. </listitem>
  9626. <listitem>
  9627. <para>Added support for passing
  9628. <parameter>img.src.path</parameter> to DocBook Java XSLT
  9629. image extensions when appropriate. Controlled using the
  9630. <parameter>graphicsize.use.img.src.path</parameter>
  9631. parameter.</para>
  9632. </listitem>
  9633. <listitem>
  9634. <para>Added support for (not
  9635. valid for DocBook 4) <tag class="attribute">xlink:href</tag>
  9636. on <tag>area</tag> and (not valid for DocBook 4)
  9637. <tag>alt</tag> in <tag>area</tag>.</para>
  9638. </listitem>
  9639. <listitem>
  9640. <para>Added new parameter
  9641. <parameter>default.table.frame</parameter> to control table
  9642. framing if there is no <tag class="attribute">frame</tag>
  9643. attribute on a table.</para>
  9644. </listitem>
  9645. <listitem>
  9646. <para>Added initial, experimental support for generating
  9647. content for the HTML <literal>title</literal> attribute from
  9648. content of the <tag>alt</tag> element. This change adds
  9649. support for the following inline elements only (none of them
  9650. are block elements):
  9651. <simplelist type="inline">
  9652. <?dbchoice choice="and"?>
  9653. <member><tag>abbrev</tag></member>
  9654. <member><tag>accel</tag></member>
  9655. <member><tag>acronym</tag></member>
  9656. <member><tag>action</tag></member>
  9657. <member><tag>application</tag></member>
  9658. <member><tag>authorinitials</tag></member>
  9659. <member><tag>beginpage</tag></member>
  9660. <member><tag>citation</tag></member>
  9661. <member><tag>citerefentry</tag></member>
  9662. <member><tag>citetitle</tag></member>
  9663. <member><tag>city</tag></member>
  9664. <member><tag>classname</tag></member>
  9665. <member><tag>code</tag></member>
  9666. <member><tag>command</tag></member>
  9667. <member><tag>computeroutput</tag></member>
  9668. <member><tag>constant</tag></member>
  9669. <member><tag>country</tag></member>
  9670. <member><tag>database</tag></member>
  9671. <member><tag>email</tag></member>
  9672. <member><tag>envar</tag></member>
  9673. <member><tag>errorcode</tag></member>
  9674. <member><tag>errorname</tag></member>
  9675. <member><tag>errortext</tag></member>
  9676. <member><tag>errortype</tag></member>
  9677. <member><tag>exceptionname</tag></member>
  9678. <member><tag>fax</tag></member>
  9679. <member><tag>filename</tag></member>
  9680. <member><tag>firstname</tag></member>
  9681. <member><tag>firstterm</tag></member>
  9682. <member><tag>foreignphrase</tag></member>
  9683. <member><tag>function</tag></member>
  9684. <member><tag>glossterm</tag></member>
  9685. <member><tag>guibutton</tag></member>
  9686. <member><tag>guiicon</tag></member>
  9687. <member><tag>guilabel</tag></member>
  9688. <member><tag>guimenu</tag></member>
  9689. <member><tag>guimenuitem</tag></member>
  9690. <member><tag>guisubmenu</tag></member>
  9691. <member><tag>hardware</tag></member>
  9692. <member><tag>honorific</tag></member>
  9693. <member><tag>interface</tag></member>
  9694. <member><tag>interfacename</tag></member>
  9695. <member><tag>keycap</tag></member>
  9696. <member><tag>keycode</tag></member>
  9697. <member><tag>keysym</tag></member>
  9698. <member><tag>lineage</tag></member>
  9699. <member><tag>lineannotation</tag></member>
  9700. <member><tag>literal</tag></member>
  9701. <member><tag>markup</tag></member>
  9702. <member><tag>medialabel</tag></member>
  9703. <member><tag>methodname</tag></member>
  9704. <member><tag>mousebutton</tag></member>
  9705. <member><tag>option</tag></member>
  9706. <member><tag>optional</tag></member>
  9707. <member><tag>otheraddr</tag></member>
  9708. <member><tag>othername</tag></member>
  9709. <member><tag>package</tag></member>
  9710. <member><tag>parameter</tag></member>
  9711. <member><tag>personname</tag></member>
  9712. <member><tag>phone</tag></member>
  9713. <member><tag>pob</tag></member>
  9714. <member><tag>postcode</tag></member>
  9715. <member><tag>productname</tag></member>
  9716. <member><tag>productnumber</tag></member>
  9717. <member><tag>prompt</tag></member>
  9718. <member><tag>property</tag></member>
  9719. <member><tag>quote</tag></member>
  9720. <member><tag>refentrytitle</tag></member>
  9721. <member><tag>remark</tag></member>
  9722. <member><tag>replaceable</tag></member>
  9723. <member><tag>returnvalue</tag></member>
  9724. <member><tag>tag</tag></member>
  9725. <member><tag>shortcut</tag></member>
  9726. <member><tag>state</tag></member>
  9727. <member><tag>street</tag></member>
  9728. <member><tag>structfield</tag></member>
  9729. <member><tag>structname</tag></member>
  9730. <member><tag>subscript</tag></member>
  9731. <member><tag>superscript</tag></member>
  9732. <member><tag>surname</tag></member>
  9733. <member><tag>symbol</tag></member>
  9734. <member><tag>systemitem</tag></member>
  9735. <member><tag>tag</tag></member>
  9736. <member><tag>termdef</tag></member>
  9737. <member><tag>token</tag></member>
  9738. <member><tag>trademark</tag></member>
  9739. <member><tag>type</tag></member>
  9740. <member><tag>uri</tag></member>
  9741. <member><tag>userinput</tag></member>
  9742. <member><tag>varname</tag></member>
  9743. <member><tag>wordasword</tag></member>
  9744. </simplelist>
  9745. </para>
  9746. </listitem>
  9747. <listitem>
  9748. <para>Added support for chunking <tag>revhistory</tag> into
  9749. separate file (similar to the support for doing same with
  9750. <tag>legalnotice</tag>). Patch from Thomas
  9751. Schraitle. Controlled through <parameter>new
  9752. generate.revhistory.link</parameter> parameter.</para>
  9753. </listitem>
  9754. <listitem>
  9755. <para>l10n.xsl: Made language codes RFC compliant. Added a
  9756. new boolean config parameter,
  9757. <parameter>l10n.lang.value.rfc.compliant</parameter>. If it
  9758. is non-zero (the default), any underscore in a language code
  9759. will be converted to a hyphen in HTML output. If it is zero,
  9760. the language code will be left as-is.</para>
  9761. </listitem>
  9762. </itemizedlist>
  9763. </sect2>
  9764. <sect2 xml:id="V1690_MAN">
  9765. <title>man</title>
  9766. <para>This release closes out 44 manpages stylesheet bug reports
  9767. and feature requests. It adds more than 35 new configuration
  9768. parameters for controlling aspects of man-page output --
  9769. including hyphenation and justification, handling of links,
  9770. conversion of Unicode characters, and contents of man-page
  9771. headers and footers.</para>
  9772. <itemizedlist>
  9773. <!-- ======================================================= -->
  9774. <listitem>
  9775. <para>New options for globally disabling/enabling
  9776. hyphenation and justification:
  9777. <parameter>man.justify</parameter> and
  9778. <parameter>man.hyphenate</parameter>.</para>
  9779. <para>Note that the default
  9780. for the both of those is zero (off), because justified text
  9781. looks good only when it is also hyphenated; to quote the
  9782. <quote>Hyphenation</quote> node from the groff info page:
  9783. <blockquote>
  9784. <para><emphasis>Since the odds are not great for finding a
  9785. set of words, for every output line, which fit nicely on a
  9786. line without inserting excessive amounts of space between
  9787. words, `gtroff' hyphenates words so that it can justify
  9788. lines without inserting too much space between
  9789. words.</emphasis></para>
  9790. </blockquote>
  9791. The problem is that groff can end up hyphenating a lot of
  9792. things that you don't want hyphenated (variable names and
  9793. command names, for example). Keeping both justification and
  9794. hyphenation disabled ensures that hyphens won't get inserted
  9795. where you don't want to them, and you don't end up with
  9796. lines containing excessive amounts of space between
  9797. words. These default settings run counter to how most
  9798. existing man pages are formatted. But there are some notable
  9799. exceptions, such as the perl man pages.</para>
  9800. </listitem>
  9801. <listitem>
  9802. <para> Added parameters for controlling hyphenation of
  9803. computer inlines, filenames, and URLs. By default, even when
  9804. hyphenation is enabled (globally), hyphenation is now
  9805. suppressed for "computer inlines" (currently, just
  9806. <tag>classname</tag>, <tag>constant</tag>, <tag>envar</tag>,
  9807. <tag>errorcode</tag>, <tag>option</tag>,
  9808. <tag>replaceable</tag>, <tag>userinput</tag>,
  9809. <tag>type</tag>, and <tag>varname</tag>, and for
  9810. <tag>filenames</tag>, and for URLs from <tag>link</tag>. It
  9811. can be (re)enabled using the
  9812. <parameter>man.hyphenate.computer.inlines</parameter>,
  9813. <parameter>man.hyphenate.filenames</parameter>, and
  9814. <parameter>man.hyphenate.urls parameters</parameter>.</para>
  9815. </listitem>
  9816. <!-- ======================================================= -->
  9817. <listitem>
  9818. <para>Implemented a new system for replacing Unicode
  9819. characters. There are two parts to the new system: a
  9820. <quote>string substitution map</quote> for doing
  9821. <quote>essential</quote> replacements, and a
  9822. <quote>character map</quote> that can optionally be disabled
  9823. and enabled.</para>
  9824. <para>The new system fixes all open bugs that had to do with
  9825. literal Unicode numbered entities such as &amp;#8220; and
  9826. &amp;#8221; showing up in output, and greatly expands the
  9827. ability of the stylesheets to generate <quote>good</quote> roff
  9828. equivalents for Unicode symbols and special
  9829. characters.</para>
  9830. <para>Here are some details...</para>
  9831. <para>The previous manpages mechanism for replacing Unicode
  9832. symbols and special characters with roff equivalents (the
  9833. <function>replace-entities</function> template) was not
  9834. scalable and not complete. The mechanism handled a somewhat
  9835. arbitrary selection of less than 20 or so Unicode
  9836. characters. But there are potentially more than
  9837. <emphasis>800</emphasis> Unicode special characters that
  9838. have some groff equivalent they can be mapped to. And there
  9839. are about 34 symbols in the Latin-1 (ISO-8859-1) block
  9840. alone. Users might reasonably expect that if they include
  9841. any of those Latin-1 characters in their DocBook source
  9842. documents, they will get correctly converted to known roff
  9843. equivalents in output.</para>
  9844. <para>In addition to those common symbols, certain users may
  9845. have a need to use symbols from other Unicode blocks. Say,
  9846. somebody who is documenting an application related to math
  9847. might need to use a bunch of symbols from the
  9848. <quote>Mathematical Operators</quote> Unicode block (there
  9849. are about 65 characters in that block that have reasonable
  9850. roff equivalents). Or somebody else might really like
  9851. Dingbats -- such as the checkmark character -- and so might
  9852. use a bunch of things from the <quote>Dingbat</quote> block
  9853. (141 characters in that that have roff equivalents or that
  9854. can at least be <quote>degraded</quote> somewhat gracefully
  9855. into roff).</para>
  9856. <para>So, the old <function>replace-entities</function>
  9857. mechanism was replaced with a completely different mechanism
  9858. that is based on use of two <quote>maps</quote>: a
  9859. <quote>substitution map</quote> and a <quote>character
  9860. map</quote> (the latter in a format compliant with the XSLT
  9861. 2.0 spec and therefore completely <quote>forward
  9862. compatible</quote> with XSLT 2.0).</para>
  9863. <para>The substitution map is controlled through the
  9864. <parameter>man.string.subst.map</parameter> parameter, and
  9865. is used to replace things like the backslash character
  9866. (which needs special handling to prevent it from being
  9867. interpreted as a roff escape). The substitution map cannot
  9868. be disabled, because disabling it will cause the output to
  9869. be broken. However, you can add to it and change it if
  9870. needed.</para>
  9871. <para>The <quote>character map</quote> mechanism, on the
  9872. other hand, can be completely disabled. It is enabled by
  9873. default, and, by default, does replacement of all Latin-1
  9874. symbols, along with most special spaces, dashes, and quotes
  9875. (about 75 characters by default). Also, you can optionally
  9876. enable a <quote>full</quote> character map that provides
  9877. support for converting all 800 or so of the characters that
  9878. have some reasonable groff equivalent.</para>
  9879. <para>The character-map mechanism is controlled through the
  9880. following parameters:
  9881. <variablelist>
  9882. <varlistentry>
  9883. <term><parameter>man.charmap.enabled</parameter></term>
  9884. <listitem><para>turns character-map support
  9885. on/off</para></listitem>
  9886. </varlistentry>
  9887. <varlistentry>
  9888. <term><parameter>man.charmap.use.subset</parameter></term>
  9889. <listitem><para>specifies that a subset of the character
  9890. map is used instead of the full map</para></listitem>
  9891. </varlistentry>
  9892. <varlistentry>
  9893. <term><parameter>man.charmap.subset.profile</parameter></term>
  9894. <listitem><para>specifies profile of character-map
  9895. subset</para></listitem>
  9896. </varlistentry>
  9897. <varlistentry>
  9898. <term><parameter>man.charmap.uri</parameter></term>
  9899. <listitem><para>specifies an alternate character map to
  9900. use instead of the <quote>standard</quote> character map
  9901. provided in the distribution</para></listitem>
  9902. </varlistentry>
  9903. </variablelist>
  9904. </para>
  9905. </listitem>
  9906. <!-- ======================================================= -->
  9907. <listitem>
  9908. <para>Implemented out-of-line handling of display of URLs
  9909. for links (currently, only for <tag>ulink</tag>). This gives
  9910. you three choices for handling of links:
  9911. <orderedlist>
  9912. <listitem>
  9913. <para>Number and list links. Each link is numbered
  9914. inline, with a number in square brackets preceding the
  9915. link contents, and a numbered list of all links is added
  9916. to the end of the document.</para>
  9917. </listitem>
  9918. <listitem>
  9919. <para>Only list links. Links are not numbered, but an
  9920. (unnumbered) list of links is added to the end of the
  9921. document.</para>
  9922. </listitem>
  9923. <listitem>
  9924. <para>Suppress links. Don't number links and don't add
  9925. any list of links to the end of the document.</para>
  9926. </listitem>
  9927. </orderedlist>
  9928. You can also choose whether links should be underlined. The
  9929. default is <quote>the works</quote> -- list, number, and
  9930. underline links. You can use the
  9931. <parameter>man.links.list.enabled</parameter>, <parameter>
  9932. man.links.are.numbered</parameter>, and
  9933. <parameter>man.links.are.underlined</parameter> parameters
  9934. to change the defaults. The default heading for the link
  9935. list is REFERENCES. You can be change that using the
  9936. <parameter>man.links.list.heading</parameter>
  9937. parameter.</para>
  9938. </listitem>
  9939. <listitem>
  9940. <para>Changed default output encoding to UTF-8. <emphasis role="bold">This does not mean that man pages are output in
  9941. raw UTF-8</emphasis>, because the character map is applied
  9942. before final output, causing all UTF-8 characters covered in
  9943. the map to be converted to roff equivalents.</para>
  9944. </listitem>
  9945. <!-- ======================================================= -->
  9946. <listitem>
  9947. <para>Added support for processing <tag>refsect3</tag> and
  9948. <tag>formalpara</tag> and nested <tag>refsection</tag>
  9949. elements, down to any arbitrary level of nesting.</para>
  9950. </listitem>
  9951. <!-- ======================================================= -->
  9952. <listitem>
  9953. <para>Output of the <literal>NAME</literal> and
  9954. <literal>SYNOPSIS</literal> and <literal>AUTHOR</literal>
  9955. headings and the headings for admonitions (<tag>note</tag>,
  9956. <tag>caution</tag>, etc.) are no longer hard-coded for
  9957. English. Instead, headings are generated for those in the
  9958. correct locale (just as the FO and HTML stylesheets
  9959. do).</para>
  9960. </listitem>
  9961. <!-- ======================================================= -->
  9962. <listitem>
  9963. <para>Re-worked mechanism for assembling page
  9964. headers/footers (the contents of the <literal>.TH</literal>
  9965. macro <quote>title line</quote>).</para>
  9966. <para>Here are some details...</para>
  9967. <para>All man pages contain a <literal>.TH</literal> roff
  9968. macro whose contents are used for rendering the <quote>title
  9969. line</quote> displayed in the header and footer of each
  9970. page. Here are a couple of examples of real-world man pages
  9971. that have useful page headers/footers: <literallayout class="monospaced">
  9972. gtk-options(7) GTK+ User's Manual gtk-options(7) &lt;-- header
  9973. GTK+ 1.2 2003-10-20 gtk-options(7) &lt;-- footer
  9974. svgalib(7) Svgalib User Manual svgalib(7) &lt;-- header
  9975. Svgalib 1.4.1 16 December 1999 svgalib(7) &lt;-- footer</literallayout></para>
  9976. <para>And here are the terms with which the
  9977. <literal>groff_man(7)</literal> man page refers to the
  9978. various parts of the header/footer: <literallayout class="monospaced">
  9979. title(section) extra3 title(section) &lt;- header
  9980. extra2 extra1 title(section) &lt;- footer</literallayout></para>
  9981. <para> Or, using the names with which the <literal>man(7)</literal>
  9982. man page refers to those same fields: <literallayout class="monospaced">
  9983. title(section) manual title(section) &lt;- page header
  9984. source date title(section) &lt;- page footer</literallayout></para>
  9985. <para>The easiest way to control the contents of those
  9986. fields is to mark up your <tag>refentry</tag> content like
  9987. the following (note that this is a <quote>minimal</quote>
  9988. example). <programlisting>
  9989. &lt;refentry&gt;
  9990. &lt;info&gt;
  9991. &lt;date&gt;2003-10-20&lt;/date&gt; <co xml:id="V1690_date-co" linkends="V1690_date"/>
  9992. &lt;/info&gt;
  9993. &lt;refmeta&gt;
  9994. &lt;refentrytitle&gt;gtk-options&lt;/refentrytitle&gt; <co xml:id="V1690_title-co" linkends="V1690_title"/>
  9995. &lt;manvolnum&gt;7&lt;/manvolnum&gt; <co xml:id="V1690_manvolnum-co" linkends="V1690_manvolnum"/>
  9996. &lt;refmiscinfo class="source-name"&gt;GTK+&lt;/refmiscinfo&gt; <co xml:id="V1690_source-name-co" linkends="V1690_source-name"/>
  9997. &lt;refmiscinfo class="version"&gt;1.2&lt;/refmiscinfo&gt; <co xml:id="V1690_version-co" linkends="V1690_version"/>
  9998. &lt;refmiscinfo class="manual"&gt;GTK+ User's Manual&lt;/refmiscinfo&gt; <co xml:id="V1690_manual-co" linkends="V1690_manual"/>
  9999. &lt;/refmeta&gt;
  10000. &lt;refnamediv&gt;
  10001. &lt;refname&gt;gtk-options&lt;/refname&gt;
  10002. &lt;refpurpose&gt;Standard Command Line Options for GTK+ Programs&lt;/refpurpose&gt;
  10003. &lt;/refnamediv&gt;
  10004. &lt;refsect1&gt;
  10005. &lt;title&gt;Description&lt;/title&gt;
  10006. &lt;para&gt;This manual page describes the command line options, which
  10007. are common to all GTK+ based applications.&lt;/para&gt;
  10008. &lt;/refsect1&gt;
  10009. &lt;/refentry&gt;</programlisting>
  10010. <calloutlist>
  10011. <callout arearefs="V1690_date-co" xml:id="V1690_date">
  10012. <para>Sets the <quote>date</quote> part of the header/footer.</para>
  10013. </callout>
  10014. <callout arearefs="V1690_title-co" xml:id="V1690_title">
  10015. <para>Sets the <quote>title</quote> part.</para>
  10016. </callout>
  10017. <callout arearefs="V1690_manvolnum-co" xml:id="V1690_manvolnum">
  10018. <para>Sets the <quote>section</quote> part.</para>
  10019. </callout>
  10020. <callout arearefs="V1690_source-name-co" xml:id="V1690_source-name">
  10021. <para>Sets the <quote>source name</quote> part.</para>
  10022. </callout>
  10023. <callout arearefs="V1690_version-co" xml:id="V1690_version">
  10024. <para>Sets the <quote>version</quote> part.</para>
  10025. </callout>
  10026. <callout arearefs="V1690_manual-co" xml:id="V1690_manual">
  10027. <para>Sets the <quote>manual</quote> part.</para>
  10028. </callout>
  10029. </calloutlist>
  10030. </para>
  10031. <para>Below are explanations of the steps the stylesheets
  10032. take to attempt to assemble and display
  10033. <quote>good</quote> headers and footer. [In the
  10034. descriptions, note that <replaceable>*info</replaceable>
  10035. is the <tag>refentry</tag> <quote>info</quote> child
  10036. (whatever its name), and
  10037. <replaceable>parentinfo</replaceable> is the
  10038. <quote>info</quote> child of its parent (again, whatever
  10039. its name).]
  10040. <variablelist>
  10041. <varlistentry>
  10042. <term>extra1 field (date)</term>
  10043. <listitem>
  10044. <para>Content of the <quote>extra1</quote> field is
  10045. what shows up in the <emphasis role="bold">center
  10046. footer</emphasis> position of each page. The
  10047. <literal>man(7)</literal> man page describes it as
  10048. <quote>the date of the last revision</quote>.</para>
  10049. <para>To provide this content, if the
  10050. <parameter>refentry.date.profile.enabled</parameter>
  10051. is non-zero, the stylesheets check the value of
  10052. <parameter>refentry.date.profile</parameter>.</para>
  10053. <para>Otherwise, by default, they check for a
  10054. <tag>date</tag> or <tag>pubdate</tag> not only in the
  10055. <replaceable>*info</replaceable> contents, but also in
  10056. the <replaceable>parentinfo</replaceable>
  10057. contents.</para>
  10058. <para>If a date cannot be found, the stylesheets now
  10059. automatically generate a localized <quote>long
  10060. format</quote> date, ensuring that this field always
  10061. has content in output.</para>
  10062. <para>However, if for some reason you want to suppress
  10063. this field, you can do so by setting a non-zero value
  10064. for <parameter>man.th.extra1.suppress</parameter>.</para>
  10065. </listitem>
  10066. </varlistentry>
  10067. <varlistentry>
  10068. <term>extra2 field (source)</term>
  10069. <listitem>
  10070. <para>On Linux systems and on systems with a modern
  10071. groff, the content of the <quote>extra2</quote> field
  10072. are what shows up in the <emphasis role="bold">left
  10073. footer</emphasis> position of each page.</para>
  10074. <para>The <literal>man(7)</literal> man page describes
  10075. this as <quote>the source of the command</quote>, and
  10076. provides the following examples:
  10077. <itemizedlist>
  10078. <listitem>
  10079. <para>For binaries, use somwething like: GNU,
  10080. NET-2, SLS Distribution, MCC Distribution.</para>
  10081. </listitem>
  10082. <listitem>
  10083. <para>For system calls, use the version of the
  10084. kernel that you are currently looking at: Linux
  10085. 0.99.11.</para>
  10086. </listitem>
  10087. <listitem>
  10088. <para>For library calls, use the source of the
  10089. function: GNU, BSD 4.3, Linux DLL 4.4.1.</para>
  10090. </listitem>
  10091. </itemizedlist>
  10092. </para>
  10093. <para>In practice, there are many pages that simply
  10094. have a version number in the <quote>source</quote>
  10095. field. So, it looks like what we have is a two-part
  10096. field,
  10097. <replaceable>Name</replaceable>&#xA0;<replaceable>Version</replaceable>,
  10098. where:
  10099. <variablelist>
  10100. <varlistentry>
  10101. <term>Name</term>
  10102. <listitem>
  10103. <para>product name (e.g., BSD) or org. name
  10104. (e.g., GNU)</para>
  10105. </listitem>
  10106. </varlistentry>
  10107. <varlistentry>
  10108. <term>Version</term>
  10109. <listitem>
  10110. <para>version name</para>
  10111. </listitem>
  10112. </varlistentry>
  10113. </variablelist>
  10114. Each part is optional. If the
  10115. <replaceable>Name</replaceable> is a product name,
  10116. then the <replaceable>Version</replaceable> is
  10117. probably the version of the product. Or there may be
  10118. no <replaceable>Name</replaceable>, in which case, if
  10119. there is a <replaceable>Version</replaceable>, it is
  10120. probably the version of the item itself, not the
  10121. product it is part of. Or, if the
  10122. <replaceable>Name</replaceable> is an organization
  10123. name, then there probably will be no
  10124. <replaceable>Version</replaceable>.
  10125. </para>
  10126. <para>To provide this content, if the
  10127. <parameter>refentry.source.name.profile.enabled</parameter>
  10128. and
  10129. <parameter>refentry.version.profile.enabled</parameter>
  10130. parameter are non-zero, the stylesheets check the
  10131. value of <parameter>refentry.source.name.profile</parameter>
  10132. <parameter>refentry.version.profile</parameter>.</para>
  10133. <para>Otherwise, by default, they check the following
  10134. places, in the following order:
  10135. <orderedlist>
  10136. <listitem>
  10137. <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
  10138. </listitem>
  10139. <listitem>
  10140. <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
  10141. </listitem>
  10142. <listitem>
  10143. <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag>[@class = 'version']</literallayout>
  10144. </listitem>
  10145. <listitem>
  10146. <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productnumber</tag></literallayout>
  10147. </listitem>
  10148. <listitem>
  10149. <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productname</tag></literallayout>
  10150. </listitem>
  10151. <listitem>
  10152. <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productname</tag></literallayout>
  10153. </listitem>
  10154. <listitem>
  10155. <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
  10156. </listitem>
  10157. <listitem>
  10158. <para>[nothing found, so leave it empty]</para>
  10159. </listitem>
  10160. </orderedlist>
  10161. </para>
  10162. </listitem>
  10163. </varlistentry>
  10164. <varlistentry>
  10165. <term>extra3 field</term>
  10166. <listitem>
  10167. <para>On Linux systems and on systems with a modern
  10168. groff, the content of the <quote>extra3</quote> field
  10169. are what shows up in the <emphasis role="bold">center
  10170. header</emphasis> position of each page. Some man
  10171. pages have <quote>extra2</quote> content, some
  10172. don't. If a particular man page has it, it is most
  10173. often <quote>context</quote> data about some larger
  10174. system the documented item belongs to (for example,
  10175. the name or description of a group of related
  10176. applications). The stylesheets now check the following
  10177. places, in the following order, to look for content to
  10178. add to the <quote>extra3</quote> field.</para>
  10179. <orderedlist>
  10180. <listitem>
  10181. <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>title</tag></literallayout>
  10182. </listitem>
  10183. <listitem>
  10184. <literallayout class="monospaced">parent's <tag>title</tag></literallayout>
  10185. </listitem>
  10186. <listitem>
  10187. <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
  10188. </listitem>
  10189. <listitem>
  10190. <para>[nothing found, so leave it empty]</para>
  10191. </listitem>
  10192. </orderedlist>
  10193. </listitem>
  10194. </varlistentry>
  10195. </variablelist>
  10196. </para>
  10197. </listitem>
  10198. <!-- ======================================================= -->
  10199. <listitem>
  10200. <para>Reworked <replaceable>*info</replaceable> gathering. For
  10201. each <tag>refentry</tag> found, the stylesheets now cache its
  10202. <replaceable>*info</replaceable> content, then check for any
  10203. valid parent of it that might have metainfo content and cache
  10204. that, if found; they then then do all further matches against
  10205. those node-sets (rather than re-selecting the original
  10206. <replaceable>*info</replaceable> nodes each time they are
  10207. needed).</para>
  10208. </listitem>
  10209. <!-- ======================================================= -->
  10210. <listitem>
  10211. <para>New option for breaking strings after forward
  10212. slashes. This enables long URLs and pathnames to be broken
  10213. across lines. Controlled through
  10214. <parameter>man.break.after.slash</parameter> parameter.</para>
  10215. </listitem>
  10216. <!-- ======================================================= -->
  10217. <listitem>
  10218. <para>Output for servicemark and trademark are now
  10219. <literal>(SM)</literal> and <literal>(TM)</literal>. There is
  10220. a groff <literal>"\(tm"</literal> escape, but output from that
  10221. is not acceptable.</para>
  10222. </listitem>
  10223. <!-- ======================================================= -->
  10224. <listitem>
  10225. <para>New option for controlling the length of the title
  10226. part of the <literal>.TH</literal> title line. Controlled
  10227. through the <parameter>man.th.title.max.length</parameter>
  10228. parameter.</para>
  10229. </listitem>
  10230. <!-- ======================================================= -->
  10231. <listitem>
  10232. <para>New option for specifying output encoding of each man
  10233. page; controlled with
  10234. <parameter>man.output.encoding</parameter> (similar to the
  10235. HTML <parameter>chunker.output.encoding </parameter>
  10236. parameter).</para>
  10237. </listitem>
  10238. <!-- ======================================================= -->
  10239. <listitem>
  10240. <para>New option for suppressing filename messages when
  10241. generating output; controlled with
  10242. <parameter>man.output.quietly</parameter> (similar to the HTML
  10243. <parameter>chunk.quietly</parameter> parameter).</para>
  10244. </listitem>
  10245. <!-- ======================================================= -->
  10246. <listitem>
  10247. <para>The text of cross-references to first-level
  10248. <tag>refentry</tag> (<tag>refsect1</tag>, top-level
  10249. <tag>refsection</tag>, <tag>refnamediv</tag>, and
  10250. <tag>refsynopsisdiv</tag>) are now capitalized.</para>
  10251. </listitem>
  10252. <!-- ======================================================= -->
  10253. <listitem>
  10254. <para>Cross-references to <tag>refnamediv</tag> now use the
  10255. localized <literal>NAME</literal> title instead of using the
  10256. first <tag>refname</tag> child. This makes the output
  10257. inconsistent with HTML and FO output, but for man-page output,
  10258. it seems to make better sense to have the
  10259. <literal>NAME</literal>. (It may actually make better sense to
  10260. do it that way in HTML and FO output as well...)</para>
  10261. </listitem>
  10262. <!-- ======================================================= -->
  10263. <listitem>
  10264. <para>Added support for processing <tag>funcparams</tag>.</para>
  10265. </listitem>
  10266. <!-- ======================================================= -->
  10267. <listitem>
  10268. <para>Removed the space that was being output between
  10269. <tag>funcdef</tag> and <tag>paramdef</tag>; example: was:
  10270. <literal>float&#xA0;rand&#xA0;(void)</literal>; now:
  10271. <literal>float&#xA0;rand(void)</literal></para>
  10272. </listitem>
  10273. <!-- ======================================================= -->
  10274. <listitem>
  10275. <para>Turned off bold formatting for the <tag>type</tag>
  10276. element when it occurs within a <tag>funcdef</tag> or
  10277. <tag>paramdef</tag></para>
  10278. </listitem>
  10279. <!-- ======================================================= -->
  10280. <listitem>
  10281. <para>Corrected rendering of <tag>simplelist</tag>. Any
  10282. <literal>&lt;simplelist&#xA0;type="inline"</literal> instance
  10283. is now rendered as a comma-separated list (also with an
  10284. optional localized <quote>and</quote> or <quote>or</quote> before the last item -- see
  10285. description elsewhere in these release notes). Any simplelist
  10286. instance whose <tag class="attribute">type</tag> is not
  10287. <literal>inline</literal> is rendered as a one-column vertical
  10288. list (ignoring the values of the <tag class="attribute">type</tag> and <tag class="attribute">columns</tag> attributes if present)</para>
  10289. </listitem>
  10290. <!-- ======================================================= -->
  10291. <listitem>
  10292. <para>Comment added at top of roff source for each page now
  10293. includes DocBook XSL stylesheets version number (as in the
  10294. HTML stylesheets)</para>
  10295. </listitem>
  10296. <!-- ======================================================= -->
  10297. <listitem>
  10298. <para>Made change to prevent <quote>sticky</quote> fonts
  10299. changes. Now, when the manpages stylesheets encounter node
  10300. sets that need to be boldfaced or italicized, they put the
  10301. <literal>\fBfoo\fR</literal> and <literal>\fIbar\fR</literal>
  10302. groff bold/italic instructions separately around each node in
  10303. the set.</para>
  10304. </listitem>
  10305. <listitem>
  10306. <para>synop.xsl: Boldface everything in
  10307. <tag>funcsynopsis</tag> output except parameters (which are in
  10308. ital). The <literal>man(7)</literal> man page says:
  10309. <blockquote>
  10310. <para>For functions, the arguments are always specified
  10311. using italics, even in the SYNOPSIS section, where the rest
  10312. of the function is specified in bold.</para>
  10313. </blockquote>
  10314. A look through the contents of the
  10315. <filename>man/man2</filename> directory shows that most
  10316. (all) existing pages do follow this <quote>everything in
  10317. funcsynopsis bold</quote> rule. That means the
  10318. <tag>type</tag> content and any punctuation (parens,
  10319. semicolons, <tag>vararg</tag>s) also must be bolded.</para>
  10320. </listitem>
  10321. <!-- ======================================================= -->
  10322. <listitem>
  10323. <para>Removed code for adding backslashes before periods/dots
  10324. in roff source, because backslashes in front of periods/dots
  10325. in roff source are needed only in the very rare case where a
  10326. period is the very first character in a line, without any
  10327. space in front of it. A better way to deal with that rare case
  10328. is for you to add a zero-width space in front of the offending
  10329. dot(s) in your source</para>
  10330. </listitem>
  10331. <!-- ======================================================= -->
  10332. <listitem>
  10333. <para>Removed special handling of the <tag>quote</tag>
  10334. element. That was hard-coded to cause anything marked up with
  10335. the <tag>quote</tag> element to be output preceded by two
  10336. backticks and followed by two apostrophes -- that is, that
  10337. old-school kludge for generating <quote>curly</quote> quotes in Emacs and
  10338. in X-Windows fonts. While Emacs still seems to support that, I
  10339. don't think X-Windows has for a long time now. And, anyway, it
  10340. looks (and has always looked) like crap when viewed on a
  10341. normal tty/console. In addition, it breaks localiztion of
  10342. <tag>quote</tag>. By default, <tag>quote</tag> content is
  10343. output with localized quotation marks, which, depending on the
  10344. locale, may or may not be left and right double quotation
  10345. marks.</para>
  10346. </listitem>
  10347. <!-- ======================================================= -->
  10348. <listitem>
  10349. <para>Changed mappings for left and right single quotation
  10350. marks. Those had previously been incorrectly mapped to the
  10351. backtick (&amp;#96;) and apostrophe (&amp;39;) characters (for
  10352. kludgy reasons -- see above). They are now correctly mapped to
  10353. the <literal>\(oq</literal> and <literal>\(cq</literal> roff
  10354. escapes. If you want the old (broken) behavior, you need to
  10355. manually change the mappings for those in the value of the
  10356. <parameter>man.string.subst.map</parameter> parameter.</para>
  10357. </listitem>
  10358. <listitem>
  10359. <para>Removed <filename>xref.xsl</filename> file. Now, of the
  10360. various cross-reference elements, only the <tag>ulink</tag>
  10361. element is handled differently; the rest are handled exactly
  10362. as the HTML stylesheets handle them, except that no hypertext
  10363. links are generated. (Because there is no equivalent hypertext
  10364. mechanism is man pages.)</para>
  10365. </listitem>
  10366. <!-- ======================================================= -->
  10367. <listitem>
  10368. <para>New option for making <quote>subheading dividers</quote> in generated
  10369. roff source. The dividers are not visible in the rendered man
  10370. page; they are just there to make the source
  10371. readable. Controlled using
  10372. <parameter>man.subheading.divider</parameter>.</para>
  10373. </listitem>
  10374. <!-- ======================================================= -->
  10375. <listitem>
  10376. <para>Fixed many places where too much space was being added
  10377. between lines.</para>
  10378. </listitem>
  10379. </itemizedlist>
  10380. <!-- end of MAN changes for 1.69.0 release -->
  10381. </sect2>
  10382. </sect1>
  10383. <!-- end of notes for 1.69.0 release -->
  10384. <sect1 xml:id="V1681">
  10385. <title>Release 1.68.1</title>
  10386. <para>The release adds localization support for Farsi (thanks to
  10387. Sina Heshmati) and improved support for the XLink-based DocBook NG
  10388. <tag>db:link</tag> element. Other than that, it is a minor
  10389. bug-fix update to the 1.68.0 release. The main thing it fixes is a
  10390. build error that caused the XSLT Java extensions to be jarred up
  10391. with the wrong package structure. Thanks to Jens Stavnstrup for
  10392. quickly reporting the problem, and to Mauritz Jeanson for
  10393. investigating and finding the cause.</para>
  10394. </sect1>
  10395. <!-- end of notes for 1.68.1 release -->
  10396. <sect1 xml:id="V1680">
  10397. <title>Release 1.68.0</title>
  10398. <para>This release includes some features changes, particularly
  10399. for FO/PDF output, and a number of bug fixes.
  10400. <itemizedlist xml:id="V1680_FO">
  10401. <title>FO</title>
  10402. <listitem>
  10403. <para>Moved footnote properties to attribute-sets.</para>
  10404. </listitem>
  10405. <listitem>
  10406. <para>Added support for side floats, margin notes, and
  10407. custom floats.</para>
  10408. </listitem>
  10409. <listitem>
  10410. <para>Added new parameters
  10411. <parameter>body.start.indent</parameter> and
  10412. <parameter>body.end.indent</parameter> to the
  10413. <parameter>set.flow.properties template</parameter>.</para>
  10414. </listitem>
  10415. <listitem>
  10416. <para>Added support for <tag class="attribute">xml:id</tag></para>
  10417. </listitem>
  10418. <listitem>
  10419. <para>Added support for
  10420. <tag>refdescriptor</tag>.</para>
  10421. </listitem>
  10422. <listitem>
  10423. <para>Added support for multiple <tag>refnamediv</tag>s.</para>
  10424. </listitem>
  10425. <listitem>
  10426. <para>Added <parameter>index.entry.properties</parameter>
  10427. attribute-set to support customization of index
  10428. entries.</para>
  10429. </listitem>
  10430. <listitem>
  10431. <para>Added <parameter>set.flow.properties
  10432. template</parameter> call to each <tag>fo:flow</tag>
  10433. to support customizations entry point.</para>
  10434. </listitem>
  10435. <listitem>
  10436. <para>Add support for <literal>@floatstyle</literal> in
  10437. <tag>figure</tag></para>
  10438. </listitem>
  10439. <listitem>
  10440. <para>Moved hardcoded properties for index division titles
  10441. to the <parameter>index.div.title.properties</parameter>
  10442. attribute-set.</para>
  10443. </listitem>
  10444. <listitem>
  10445. <para>Added support for
  10446. <tag>table-layout</tag>="<tag class="attvalue">auto</tag>" for XEP.</para>
  10447. </listitem>
  10448. <listitem>
  10449. <para>Added <parameter>index.div.title.properties</parameter>
  10450. attribute-set.</para>
  10451. </listitem>
  10452. <listitem>
  10453. <para><parameter>$verbose</parameter> parameter is now
  10454. passed to most elements.</para>
  10455. </listitem>
  10456. <listitem>
  10457. <para>Added <tag>refentry</tag> to
  10458. <tag>toc</tag> in <tag>part</tag>, as it is
  10459. permitted by the DocBook schema/DTD.</para>
  10460. </listitem>
  10461. <listitem>
  10462. <para>Added backmatter elements and
  10463. <tag>article</tag> to <tag>toc</tag> in
  10464. <tag>part</tag>, since they are permitted by the
  10465. DocBook schema/DTD.</para>
  10466. </listitem>
  10467. <listitem>
  10468. <para>Added <tag class="attribute">mode</tag>="<tag class="attvalue">toc</tag>" for
  10469. <tag>simplesect</tag>, since it is now permitted in
  10470. the <tag>toc</tag> if
  10471. <parameter>simplesect.in.toc</parameter> is set.</para>
  10472. </listitem>
  10473. <listitem>
  10474. <para>Moved hard-coded properties to
  10475. <parameter>nongraphical.admonintion.properties</parameter>
  10476. and <parameter>graphical.admonition.properties</parameter>
  10477. attribute sets.</para>
  10478. </listitem>
  10479. <listitem>
  10480. <para>Added support for <literal>sidebar-width</literal> and
  10481. <literal>float-type</literal> processing instructions in
  10482. <tag>sidebar</tag>.</para>
  10483. </listitem>
  10484. <listitem>
  10485. <para>For tables with HTML markup elements, added support
  10486. for <literal>dbfo bgcolor</literal> PI, the attribute-sets
  10487. named <parameter>table.properties</parameter>,
  10488. <parameter>informaltable.properties</parameter>,
  10489. <parameter>table.table.properties</parameter>, and
  10490. <parameter>table.cell.padding</parameter>. Also added
  10491. support for the templates named
  10492. <parameter>table.cell.properties</parameter> and
  10493. <parameter>table.cell.block.properties</parameter> so that
  10494. tabstyles can be implemented. Also added support for tables
  10495. containing only <tag>tr</tag> instead of
  10496. <tag>tbody</tag> with <tag>tr</tag>.</para>
  10497. </listitem>
  10498. <listitem>
  10499. <para>Added new paramater
  10500. <parameter>hyphenate.verbatim.characters</parameter> which
  10501. can specify characters after which a line break can occur in
  10502. verbatim environments. This parameter can be used to extend
  10503. the initial set of characters which contain only space and
  10504. non-breakable space.</para>
  10505. </listitem>
  10506. <listitem>
  10507. <para>Added <parameter>itemizedlist.label.markup</parameter> to enable
  10508. selection of different bullet symbol. Also added several
  10509. potential bullet characters, commented out by default.</para>
  10510. </listitem>
  10511. <listitem>
  10512. <para>Enabled all id's in XEP output for external olinking.</para>
  10513. </listitem>
  10514. </itemizedlist>
  10515. <itemizedlist xml:id="V1680_HTML">
  10516. <title>HTML</title>
  10517. <listitem>
  10518. <para>Added support for
  10519. <tag>refdescriptor</tag>.</para>
  10520. </listitem>
  10521. <listitem>
  10522. <para>Added support for multiple <tag>refnamediv</tag>s.</para>
  10523. </listitem>
  10524. <listitem>
  10525. <para>Added support for <tag class="attribute">xml:id</tag></para>
  10526. </listitem>
  10527. <listitem>
  10528. <para><tag>refsynopsisdiv</tag> as a section for
  10529. counting section levels</para>
  10530. </listitem>
  10531. </itemizedlist>
  10532. <itemizedlist xml:id="V1680_images">
  10533. <title>Images</title>
  10534. <listitem>
  10535. <para>Added new SVG admonition graphics and navigation images.</para>
  10536. </listitem>
  10537. </itemizedlist>
  10538. </para>
  10539. </sect1>
  10540. <!-- end of notes for 1.68.0 release -->
  10541. <sect1 xml:id="V1672">
  10542. <title>Release 1.67.2</title>
  10543. <para>This release fixes a table bug introduced in the 1.67.1
  10544. release.</para>
  10545. </sect1>
  10546. <sect1 xml:id="V1671">
  10547. <title>Release 1.67.1</title>
  10548. <para>This release includes a number of bug fixes.</para>
  10549. <para>The following lists provide details about API and feature changes.
  10550. <itemizedlist xml:id="V1671_FO">
  10551. <title>FO</title>
  10552. <listitem>
  10553. <para>Tables: Inherited cell properties are now passed to the
  10554. <literal>table.cell.properties</literal> template so they can
  10555. be overridden by a customization.</para>
  10556. </listitem>
  10557. <listitem>
  10558. <para>Tables: Added support for bgcolor PI on table row
  10559. element.</para>
  10560. </listitem>
  10561. <listitem>
  10562. <para>TOCs: Added new parameter
  10563. <parameter>simplesect.in.toc</parameter>; default value of
  10564. <literal>0</literal> causes simplesect to be omitted from TOCs; to
  10565. cause <tag>simplesect</tag> to be included in TOCs, you
  10566. must set the value of <parameter>simplesect.in.toc</parameter> to
  10567. <literal>1</literal>.Comment from Norm:
  10568. <blockquote>
  10569. <para><emphasis>Simplesect elements aren't supposed to
  10570. appear in the ToC at all... The use case for simplesect
  10571. is when, for example, every chapter in a book ends with
  10572. "Exercises" or "For More Information" sections and you
  10573. don't want those to appear in the ToC.</emphasis></para>
  10574. </blockquote>
  10575. </para>
  10576. </listitem>
  10577. <listitem>
  10578. <para>Sections: Reverted change that caused a variable reference
  10579. to be used in a template match and rewrote code to preserve
  10580. intended semantics.</para>
  10581. </listitem>
  10582. <listitem>
  10583. <para>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
  10584. list output from PassiveTeX</para>
  10585. </listitem>
  10586. <listitem>
  10587. <para>Moved the literal attributes from
  10588. <parameter>component.title</parameter> to the
  10589. <parameter>component.title.properties</parameter> attribute-set so
  10590. they can be customized.</para>
  10591. </listitem>
  10592. <listitem>
  10593. <para>Lists: Added <tag>glossdef</tag>'s first
  10594. <tag>para</tag> to special handling in
  10595. <literal>fo:list-item-body</literal>.</para>
  10596. </listitem>
  10597. </itemizedlist>
  10598. <itemizedlist xml:id="V1671_HTML">
  10599. <title>HTML</title>
  10600. <listitem>
  10601. <para>TOCs: Added new parameter
  10602. <parameter>simplesect.in.toc</parameter>; for details, see
  10603. the list of <xref linkend="V1671_FO"/> changes for this
  10604. release.</para>
  10605. </listitem>
  10606. <listitem>
  10607. <para>Indexing: Added new parameter
  10608. <parameter>index.prefer.titleabbrev</parameter>; when set to
  10609. <literal>1</literal>, index references will use
  10610. <tag>titleabbrev</tag> instead of
  10611. <tag>title</tag> when available.</para>
  10612. </listitem>
  10613. </itemizedlist>
  10614. <itemizedlist xml:id="V1671_HELP">
  10615. <title>HTML Help</title>
  10616. <listitem>
  10617. <para>Added support for generating windows-1252-encoded
  10618. output using Saxon; for more details, see the list of <xref linkend="V1671_EXT"/> changes for this release.</para>
  10619. </listitem>
  10620. </itemizedlist>
  10621. <itemizedlist xml:id="V1671_MAN">
  10622. <title>man pages</title>
  10623. <listitem>
  10624. <para>Replaced named/numeric character-entity references for
  10625. non-breaking space with groff equivalent (backslash-tilde).</para>
  10626. </listitem>
  10627. </itemizedlist>
  10628. <itemizedlist xml:id="V1671_EXT">
  10629. <title>XSL Java extensions</title>
  10630. <listitem>
  10631. <para>Saxon extensions: Added the
  10632. <classname>Windows1252</classname> class. It extends Saxon
  10633. 6.5.x with the windows-1252 character set, which is
  10634. particularly useful when generating HTML Help for Western
  10635. European Languages (code from
  10636. <personname><firstname>Pontus</firstname>
  10637. <surname>Haglund</surname></personname> and contributed to the
  10638. DocBook community by Sectra AB, Sweden).</para>
  10639. <para>To use:
  10640. <orderedlist>
  10641. <listitem>
  10642. <para>Make sure that the Saxon 6.5.x jar file and the jar file for
  10643. the DocBook XSL Java extensions are in your <envar>CLASSPATH</envar></para>
  10644. </listitem>
  10645. <listitem>
  10646. <para>Create a DocBook XSL customization layer -- a file named
  10647. <filename>mystylesheet.xsl</filename> or whatever -- that, at a
  10648. minimum, contains the following:
  10649. <screen> &lt;xsl:stylesheet
  10650. xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  10651. version='1.0'&gt;
  10652. &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/&gt;
  10653. &lt;xsl:output method="html" encoding="WINDOWS-1252" indent="no"/&gt;
  10654. &lt;xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
  10655. &lt;xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
  10656. &lt;xsl:param name="saxon.character.representation" select="'native'"&gt;&lt;/xsl:param&gt;
  10657. &lt;/xsl:stylesheet&gt;</screen>
  10658. </para>
  10659. <para>Invoke Saxon with the
  10660. <literal>encoding.windows-1252</literal> Java system property set
  10661. to <literal>com.nwalsh.saxon.Windows1252</literal>; for example
  10662. <screen> java \
  10663. -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
  10664. com.icl.saxon.StyleSheet \
  10665. mydoc.xml mystylesheet.xsl</screen>
  10666. Or, for a more complete "real world" case showing other
  10667. options you'll typically want to use:
  10668. <screen> java \
  10669. -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
  10670. -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
  10671. -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
  10672. -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
  10673. com.icl.saxon.StyleSheet \
  10674. -x org.apache.xml.resolver.tools.ResolvingXMLReader \
  10675. -y org.apache.xml.resolver.tools.ResolvingXMLReader \
  10676. -r org.apache.xml.resolver.tools.CatalogResolver \
  10677. mydoc.xml mystylesheet.xsl</screen>
  10678. In both cases, the "mystylesheet.xsl" file should be a
  10679. DocBook customization layer containing the parameters
  10680. show in step 2.</para>
  10681. </listitem>
  10682. </orderedlist>
  10683. </para>
  10684. </listitem>
  10685. <listitem>
  10686. <para>Saxon extensions: Removed Saxon 8 extensions from release package</para>
  10687. </listitem>
  10688. </itemizedlist>
  10689. </para>
  10690. </sect1>
  10691. <sect1 xml:id="V1670">
  10692. <title>Release 1.67.0</title>
  10693. <itemizedlist>
  10694. <listitem>
  10695. <para>A number of important bug fixes.</para>
  10696. </listitem>
  10697. <listitem>
  10698. <para>Added Saxon8 extensions</para>
  10699. </listitem>
  10700. <listitem>
  10701. <para>Enabled <literal>dbfo table-width</literal> on
  10702. <tag>entrytbl</tag> in FO output</para>
  10703. </listitem>
  10704. <listitem>
  10705. <para>Added support for <literal>role=strong</literal> on
  10706. <tag>emphasis</tag> in FO output</para>
  10707. </listitem>
  10708. <listitem>
  10709. <para>Added new FO parameter
  10710. <parameter>hyphenate.verbatim</parameter> that can be used to turn
  10711. on "intelligent" wrapping of verbatim environments.</para>
  10712. </listitem>
  10713. <listitem>
  10714. <para>Replaced all <literal>&lt;tt&gt;&lt;/tt&gt;</literal> output with
  10715. <literal>&lt;code&gt;&lt;/code&gt;</literal></para>
  10716. </listitem>
  10717. <listitem>
  10718. <para>Changed <literal>admon.graphic.width</literal> template to a
  10719. mode so that different admonitions can have different graphical
  10720. widths.</para>
  10721. </listitem>
  10722. <listitem>
  10723. <para>Deprecated the HTML <parameter>shade.verbatim</parameter>
  10724. parameter (use CSS instead)</para>
  10725. </listitem>
  10726. <listitem>
  10727. <para>Wrapped ToC
  10728. <tag>refentrytitle</tag>/<tag>refname</tag> and
  10729. <tag>refpurpose</tag> in span with class values. This
  10730. makes it possible to style them using a CSS stylesheet.</para>
  10731. </listitem>
  10732. <listitem>
  10733. <para>Use <literal>strong/em</literal> instead of
  10734. <literal>b/i</literal> in HTML output</para>
  10735. </listitem>
  10736. <listitem>
  10737. <para>Added support for converting <tag>Emphasis</tag> to
  10738. groff italic and <tag>Emphasis role='bold'</tag> to
  10739. bold. Controlled by
  10740. <parameter>emphasis.propagates.style</parameter> param, but not
  10741. documented yet using litprog system. Will do that next (planning
  10742. to add some other parameter-controllable options for hyphenation
  10743. and handling of line spacing).</para>
  10744. </listitem>
  10745. <listitem>
  10746. <para><parameter>callout.graphics.number.limit.xml</parameter>
  10747. param: Changed the default from <literal>10</literal> to
  10748. <literal>15</literal>.</para>
  10749. </listitem>
  10750. <listitem>
  10751. <para><parameter>verbatim.properties</parameter>: Added
  10752. <literal>hyphenate=false</literal></para>
  10753. </listitem>
  10754. <listitem>
  10755. <para>Saxon and Xalan Text.java extensions: Added support for
  10756. <methodname>URIResolver()</methodname> on insertfile href's</para>
  10757. </listitem>
  10758. <listitem>
  10759. <para>Added generated <filename>RELEASE-NOTES.txt</filename>
  10760. file.</para>
  10761. </listitem>
  10762. <listitem>
  10763. <para>Added <filename>INSTALL</filename> file (executable file for
  10764. generating catalog.xml)</para>
  10765. </listitem>
  10766. <listitem>
  10767. <para>Removed obsolete <filename>tools</filename> directory from
  10768. package</para>
  10769. </listitem>
  10770. </itemizedlist>
  10771. </sect1>
  10772. <sect1 xml:id="V1661">
  10773. <title>Release 1.66.1</title>
  10774. <itemizedlist>
  10775. <listitem>
  10776. <para>A number of important bug fixes.
  10777. </para>
  10778. </listitem>
  10779. <listitem>
  10780. <para>
  10781. Now <literal>xml:base</literal> attributes that are generated by an
  10782. XInclude processor are resolved for image files.
  10783. </para>
  10784. </listitem>
  10785. <listitem>
  10786. <para>
  10787. Rewrote olink templates to support several new features.
  10788. </para>
  10789. <itemizedlist>
  10790. <listitem>
  10791. <para>
  10792. Extended full olink support to FO output.
  10793. </para>
  10794. </listitem>
  10795. <listitem>
  10796. <para>
  10797. Add support for <literal>xrefstyle</literal> attribute in olinks.
  10798. </para>
  10799. </listitem>
  10800. <listitem>
  10801. <para>
  10802. New parameters to support new olink features:
  10803. <parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
  10804. <parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
  10805. <parameter>prefer.internal.olink</parameter>.
  10806. See the reference page for each parameter for more
  10807. information.</para>
  10808. </listitem>
  10809. </itemizedlist>
  10810. </listitem>
  10811. <listitem>
  10812. <para>
  10813. Added <parameter>index.on.type</parameter> parameter for new <tag class="attribute">type</tag>
  10814. attribute introduced in DocBook 4.3 for indexterms and index.
  10815. This allows you to create multiple indices containing
  10816. different categories of entries.
  10817. For users of 4.2 and earlier, you can use the new parameter <parameter>index.on.role</parameter>
  10818. instead.
  10819. </para>
  10820. </listitem>
  10821. <listitem>
  10822. <para>
  10823. Added new
  10824. <parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
  10825. below a certain depth.
  10826. This permits you to number major section levels and leave minor
  10827. section levels unnumbered.</para>
  10828. </listitem>
  10829. <listitem>
  10830. <para>
  10831. Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
  10832. the line separating footnotes in printed output.
  10833. </para>
  10834. </listitem>
  10835. <listitem>
  10836. <para>
  10837. Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
  10838. attributes.
  10839. The prefix is added to whatever path is already generated by the
  10840. stylesheet for each image file.</para>
  10841. </listitem>
  10842. <listitem>
  10843. <para>
  10844. Added new attribute-sets
  10845. <parameter>informalequation.properties</parameter>,
  10846. <parameter>informalexample.properties</parameter>,
  10847. <parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
  10848. so each such element type can be formatted
  10849. individually if needed.
  10850. </para>
  10851. </listitem>
  10852. <listitem>
  10853. <para>
  10854. Add <parameter>component.label.includes.part.label</parameter>
  10855. parameter to add any part number to chapter, appendix
  10856. and other component labels when
  10857. the <parameter>label.from.part</parameter> parameter is nonzero.
  10858. This permits you to distinguish multiple chapters with the same
  10859. chapter number in cross references and the TOC.</para>
  10860. </listitem>
  10861. <listitem>
  10862. <para>
  10863. Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
  10864. This parameter lets you generate separate chunk files for each LOT
  10865. (list of tables, list of figures, etc.).</para>
  10866. </listitem>
  10867. <listitem>
  10868. <para>Added several table features:</para>
  10869. <itemizedlist>
  10870. <listitem>
  10871. <para>
  10872. Added <parameter>table.table.properties</parameter> attribute set to add
  10873. properties to the fo:table element.
  10874. </para>
  10875. </listitem>
  10876. <listitem>
  10877. <para>
  10878. Added placeholder templates named <literal>table.cell.properties</literal>
  10879. and <literal>table.cell.block.properties</literal> to enable adding properties
  10880. to any <tag>fo:table-cell</tag> or the cell's <tag>fo:block</tag>, respectively.
  10881. These templates are a start for implementing table styles.</para>
  10882. </listitem>
  10883. </itemizedlist>
  10884. </listitem>
  10885. <listitem>
  10886. <para>
  10887. Added new attribute
  10888. set <parameter>component.title.properties</parameter> for easy modifications of
  10889. component's title formatting in FO output.
  10890. </para>
  10891. </listitem>
  10892. <listitem>
  10893. <para>
  10894. Added Saxon support for an <tag class="attribute">encoding</tag> attribute on the <tag class="element">textdata</tag> element. Added new parameter
  10895. <parameter>textdata.default.encoding</parameter> which specifies encoding when
  10896. <tag class="attribute">encoding</tag> attribute on
  10897. <tag class="element">textdata</tag> is missing.
  10898. </para>
  10899. </listitem>
  10900. <listitem>
  10901. <para>
  10902. Template <literal>label.this.section</literal> now controls whole
  10903. section label, not only sub-label which corresponds to
  10904. particular label. Former behaviour was IMHO bug as it was
  10905. not usable.
  10906. </para>
  10907. </listitem>
  10908. <listitem>
  10909. <para>
  10910. Formatting in titleabbrev for TOC and headers
  10911. is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup.
  10912. </para>
  10913. </listitem>
  10914. <listitem>
  10915. <para>
  10916. Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
  10917. property</literal> for page sequences in print output.
  10918. Customizing this template lets you change when page numbering restarts. This is similar to the <literal>format.page.number</literal> template that lets you change how the page number formatting changes in the output.
  10919. </para>
  10920. </listitem>
  10921. <listitem>
  10922. <para>
  10923. Added <literal>force.page.count</literal> template to set the force-page-count
  10924. property for page sequences in print output.
  10925. This is similar to the <literal>format.page.number</literal> template.
  10926. </para>
  10927. </listitem>
  10928. <listitem>
  10929. <para>
  10930. Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document
  10931. lang, not from system environment.
  10932. </para>
  10933. </listitem>
  10934. <listitem>
  10935. <para>
  10936. Numbering and formatting of normal
  10937. and ulink footnotes (if turned on) has been unified.
  10938. Now ulink footnotes are mixed in with any other footnotes.</para>
  10939. </listitem>
  10940. <listitem>
  10941. <para>
  10942. Added support for <tag>renderas</tag> attribute in section and
  10943. sect1 et al.
  10944. This permits you to render a given section title as if it were a different level.</para>
  10945. </listitem>
  10946. <listitem>
  10947. <para>
  10948. Added support for <tag>label</tag> attribute in footnote to manually
  10949. supply the footnote mark.
  10950. </para>
  10951. </listitem>
  10952. <listitem>
  10953. <para>
  10954. Added support for DocBook 4.3 <tag>corpcredit</tag> element.
  10955. </para>
  10956. </listitem>
  10957. <listitem>
  10958. <para>
  10959. Added support for a <literal>dbfo keep-together</literal> PI for
  10960. formal objects (table, figure, example, equation, programlisting). That permits a formal object to be kept together if it is not already, or to be broken if it
  10961. is very long and the
  10962. default keep-together is not appropriate.
  10963. </para>
  10964. </listitem>
  10965. <listitem>
  10966. <para>
  10967. For graphics files, made file extension matching case
  10968. insensitive, and updated the list of graphics extensions.
  10969. </para>
  10970. </listitem>
  10971. <listitem>
  10972. <para>
  10973. Allow <tag>calloutlist</tag> to have block content before
  10974. the first callout
  10975. </para>
  10976. </listitem>
  10977. <listitem>
  10978. <para>
  10979. Added <literal>dbfo-need</literal> processing instruction to provide
  10980. soft page breaks.
  10981. </para>
  10982. </listitem>
  10983. <listitem>
  10984. <para>
  10985. Added implementation of existing but unused
  10986. <parameter>default.image.width</parameter> parameter for graphics.
  10987. </para>
  10988. </listitem>
  10989. <listitem>
  10990. <para>
  10991. Support DocBook NG <tag>tag</tag> inline element.
  10992. </para>
  10993. </listitem>
  10994. <listitem>
  10995. <para>
  10996. It appears that XEP now supports Unicode characters in
  10997. bookmarks. There is no further need to strip accents from
  10998. characters.
  10999. </para>
  11000. </listitem>
  11001. <listitem>
  11002. <para>
  11003. Make <tag>segmentedlist</tag> HTML markup
  11004. more semantic and available to CSS styles.
  11005. </para>
  11006. </listitem>
  11007. <listitem>
  11008. <para>
  11009. Added <literal>user.preroot</literal> placeholder template to
  11010. permit xsl-stylesheet and other PIs and comments to be
  11011. output before the HTML root element.
  11012. </para>
  11013. </listitem>
  11014. <listitem>
  11015. <para>
  11016. Non-chunked legalnotice now gets an &lt;a
  11017. name="id"&gt; element in HTML output
  11018. so it can be referenced with xref or link.
  11019. </para>
  11020. </listitem>
  11021. <listitem>
  11022. <para>
  11023. In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
  11024. and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
  11025. spec.
  11026. </para>
  11027. </listitem>
  11028. <listitem>
  11029. <para>
  11030. Added several patches to htmlhelp from W. Borgert
  11031. </para>
  11032. </listitem>
  11033. <listitem>
  11034. <para>
  11035. Added Bosnian locale file as common/bs.xml.
  11036. </para>
  11037. </listitem>
  11038. </itemizedlist>
  11039. </sect1>
  11040. <sect1 xml:id="V1650">
  11041. <title>Release 1.65.0</title>
  11042. <itemizedlist>
  11043. <listitem>
  11044. <para>A number of important bug fixes.
  11045. </para>
  11046. </listitem>
  11047. <listitem>
  11048. <para>Added a workaround to allow these stylesheets to process DocBook NG
  11049. documents. (It&#x2019;s a hack that pre-processes the document to strip off the
  11050. namespace and then uses <function>exsl:node-set</function> to process
  11051. the result.)
  11052. </para>
  11053. </listitem>
  11054. <listitem>
  11055. <para>Added alternative indexing mechanism which has better
  11056. internationalization support. New indexing method allows grouping of
  11057. accented letters like e, &#xE9;, &#xEB; into the same group under letter "e". It
  11058. can also treat special letters (e.g. "ch") as one character and place
  11059. them in the correct position (e.g. between "h" and "i" in Czech
  11060. language).</para>
  11061. <para>In order to use this mechanism you must create customization
  11062. layer which imports some base stylesheet (like
  11063. <filename>fo/docbook.xsl</filename>,
  11064. <filename>html/chunk.xsl</filename>) and then includes appropriate
  11065. stylesheet with new indexing code
  11066. (<filename>fo/autoidx-ng.xsl</filename> or
  11067. <filename>html/autoidx-ng.xsl</filename>). For example:</para>
  11068. <programlisting>&lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  11069. version="1.0"&gt;
  11070. &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/&gt;
  11071. &lt;xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/&gt;
  11072. &lt;/xsl:stylesheet&gt;</programlisting>
  11073. <para>New method is known to work with Saxon and it should also work
  11074. with xsltproc 1.1.1 and later. Currently supported languages are
  11075. English, Czech, German, French, Spanish and Danish.</para>
  11076. </listitem>
  11077. </itemizedlist>
  11078. </sect1>
  11079. <sect1 xml:id="V1641">
  11080. <title>Release 1.64.1</title>
  11081. <itemizedlist>
  11082. <para>General bug fixes and improvements. Sorry about the failure to produce
  11083. an updated release notes file for 1.62.0&#x2014;1.63.2</para>
  11084. <listitem>
  11085. <para>In the course of fixing bug #849787, wrapping Unicode callouts
  11086. with an appropriate font change in the Xalan extensions, I discovered
  11087. that the Xalan APIs have changed a bit. So <filename>xalan2.jar</filename>
  11088. will work with older Xalan 2 implementations, <filename>xalan25.jar</filename>
  11089. works with Xalan 2.5.</para>
  11090. </listitem>
  11091. </itemizedlist>
  11092. </sect1>
  11093. <sect1 xml:id="V1610">
  11094. <title>Release 1.61.0</title>
  11095. <itemizedlist>
  11096. <para>Lots of bug fixes and improvements.</para>
  11097. <listitem>
  11098. <para>Initial support for timestamp PI. From now you
  11099. can use &lt;?dbtimestamp format="Y-m-d H:M:S"?&gt; to get current
  11100. datetime in your document. Added localization support for datetime PI
  11101. </para>
  11102. </listitem>
  11103. <listitem>
  11104. <para>Added level 6 to test for <tag>section</tag> depth in
  11105. section.level template so that
  11106. section.title.level6.properties will be used for sections
  11107. that are 6 deep or deeper. This should also cause a h6 to be
  11108. created in html output.
  11109. </para>
  11110. </listitem>
  11111. <listitem>
  11112. <para>Don't use SVG graphics if <parameter>use.svg</parameter>=0
  11113. </para>
  11114. </listitem>
  11115. <listitem>
  11116. <para>Now uses number-and-title-template for sections
  11117. only if <parameter>section.autolabel</parameter> is not zero.
  11118. </para>
  11119. </listitem>
  11120. <listitem>
  11121. <para>Added missing 'english-language-name' attribute to
  11122. the l10n element, and the missing 'style' attribute to the
  11123. template element so the current gentext documents will
  11124. validate.
  11125. </para>
  11126. </listitem>
  11127. <listitem>
  11128. <para>Corrected several references to parameter
  11129. <parameter>qanda.defaultlabel</parameter> that were missing the "$".
  11130. </para>
  11131. </listitem>
  11132. <listitem>
  11133. <para>Now accepts <parameter>admon.textlabel</parameter> parameter to turn off
  11134. Note, Warning, etc. label.
  11135. </para>
  11136. </listitem>
  11137. <listitem>
  11138. <para>FeatReq #684561: support more XEP metadata
  11139. </para>
  11140. </listitem>
  11141. <listitem>
  11142. <para>Added hyphenation support. Added support for <tag>coref</tag>.
  11143. Added <tag>beginpage</tag> support. (does nothing; see TDG).
  11144. </para>
  11145. </listitem>
  11146. <listitem>
  11147. <para>Added support for
  11148. hyphenation-character, hyphenation-push-character-count, and
  11149. hyphenation-remain-character-count
  11150. </para>
  11151. </listitem>
  11152. <listitem>
  11153. <para>Added <parameter>root.properties</parameter>,
  11154. <parameter>ebnf.assignment</parameter>,
  11155. and <parameter>ebnf.statement.terminator</parameter>
  11156. </para>
  11157. </listitem>
  11158. <listitem>
  11159. <para>Support bgcolor PI in table cells; make sure
  11160. rowsep and colsep don't have any effect on the last row or
  11161. column
  11162. </para>
  11163. </listitem>
  11164. <listitem>
  11165. <para>Handle <tag>othercredit</tag> on titlepage a little
  11166. better
  11167. </para>
  11168. </listitem>
  11169. <listitem>
  11170. <para>Applied fix from Jeff Beal that fixed the bug
  11171. that put secondary page numbers on primary entries. Same
  11172. with tertiary page numbers on secondary entries.
  11173. </para>
  11174. </listitem>
  11175. <listitem>
  11176. <para>Added definition of missing variable
  11177. <parameter>collection</parameter>.
  11178. </para>
  11179. </listitem>
  11180. <listitem>
  11181. <para>Make <tag>footnote</tag> formatting 'normal' even when it
  11182. occurs in a context that has special formatting
  11183. </para>
  11184. </listitem>
  11185. <listitem>
  11186. <para>Added warning when <parameter>glossary.collection</parameter> is not
  11187. blank, but it cannot open the specified file.
  11188. </para>
  11189. </listitem>
  11190. <listitem>
  11191. <para>Pick up the frame attribute on <tag>table</tag> and
  11192. <tag>informaltable</tag>.
  11193. </para>
  11194. </listitem>
  11195. <listitem>
  11196. <para><tag>indexdiv</tag>/<tag>title</tag>
  11197. in non-autogenerated indexes are
  11198. now picked up.
  11199. </para>
  11200. </listitem>
  11201. <listitem>
  11202. <para>Removed (unused)
  11203. component.title.properties
  11204. </para>
  11205. </listitem>
  11206. <listitem>
  11207. <para>Move IDs from
  11208. page-sequences down to titlepage blocks
  11209. </para>
  11210. </listitem>
  11211. <listitem>
  11212. <para>Use
  11213. proportional-column-width(1) on more <tag>table</tag>s.
  11214. </para>
  11215. <para>Use proportional-column-width() for
  11216. header/footer tables; suppress relative-align when when
  11217. using FOP
  11218. </para>
  11219. </listitem>
  11220. <listitem>
  11221. <para>Check for <parameter>glossterm.auto.link</parameter> when linking
  11222. firstterms; don't output gl. prefix on glossterm links
  11223. </para>
  11224. </listitem>
  11225. <listitem>
  11226. <para>Generate Part ToCs
  11227. </para>
  11228. </listitem>
  11229. <listitem>
  11230. <para>Support <tag>glossary</tag>, <tag>bibliography</tag>,
  11231. and <tag>index</tag> in component ToCs.
  11232. </para>
  11233. </listitem>
  11234. <listitem>
  11235. <para>Refactored chunking code so that
  11236. customization of chunk algorithm and chunk elements is more
  11237. practical
  11238. </para>
  11239. </listitem>
  11240. <listitem>
  11241. <para>Support <tag>textobject</tag>/<tag>phrase</tag>
  11242. on <tag>inlinemediaobject</tag>.
  11243. </para>
  11244. </listitem>
  11245. <listitem>
  11246. <para>Support 'start' PI on ordered lists
  11247. </para>
  11248. </listitem>
  11249. <listitem>
  11250. <para>Fixed test of $toc PI to turn on qandaset TOC.
  11251. </para>
  11252. </listitem>
  11253. <listitem>
  11254. <para>Added process.chunk.footnotes to sect2 through
  11255. 5 to fix bug of missing footnotes when chunk level greater
  11256. than 1.
  11257. </para>
  11258. </listitem>
  11259. <listitem>
  11260. <para>Added
  11261. paramater <parameter>toc.max.depth</parameter> which controls maximal depth of ToC
  11262. as requested by PHP-DOC group.
  11263. </para>
  11264. </listitem>
  11265. <listitem>
  11266. <para>Exempted <tag>titleabbrev</tag> from preamble processing in
  11267. lists, and fixed variablelist preamble code to use the same
  11268. syntax as the other lists.
  11269. </para>
  11270. </listitem>
  11271. <listitem>
  11272. <para>Added support for elements between variablelist
  11273. and first varlistentry since DocBook 4.2 supports that now.
  11274. </para>
  11275. </listitem>
  11276. </itemizedlist>
  11277. </sect1>
  11278. <sect1 xml:id="V1601">
  11279. <title>Release 1.60.1</title>
  11280. <itemizedlist>
  11281. <para>Lots of bug fixes.</para>
  11282. <listitem>
  11283. <para>The format of the <filename>titlepage.templates.xml</filename> files and
  11284. the stylesheet that transforms them have been significantly changed. All of the
  11285. attributes used to control the templates are now namespace qualified. So what
  11286. used to be:</para>
  11287. <programlisting>&lt;t:titlepage element="article" wrapper="fo:block"&gt;</programlisting>
  11288. <para>is now:</para>
  11289. <programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"&gt;</programlisting>
  11290. <para>Attributes from other namespaces (including those that are unqualified) are
  11291. now copied directly through. In practice, this means that the names that used
  11292. to be <quote>fo:</quote> qualified:</para>
  11293. <programlisting>&lt;title named-template="component.title"
  11294. param:node="ancestor-or-self::article[1]"
  11295. fo:text-align="center"
  11296. fo:keep-with-next="always"
  11297. fo:font-size="&amp;hsize5;"
  11298. fo:font-weight="bold"
  11299. fo:font-family="{$title.font.family}"/&gt;</programlisting>
  11300. <para>are now unqualified:</para>
  11301. <programlisting>&lt;title t:named-template="component.title"
  11302. param:node="ancestor-or-self::article[1]"
  11303. text-align="center"
  11304. keep-with-next="always"
  11305. font-size="&amp;hsize5;"
  11306. font-weight="bold"
  11307. font-family="{$title.font.family}"/&gt;</programlisting>
  11308. <para>The <tag>t:titlepage</tag> and <tag>t:titlepage-content</tag>
  11309. elements both generate wrappers now. And unqualified attributes on those elements
  11310. are passed through. This means that you can now make the title font apply to
  11311. ane entire titlepage and make the entire <quote>recto</quote>
  11312. titlepage centered by specifying the font and alignment on the those elements:</para>
  11313. <programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"
  11314. font-family="{$title.font.family}"&gt;
  11315. &lt;t:titlepage-content t:side="recto"
  11316. text-align="center"&gt;</programlisting>
  11317. </listitem>
  11318. <listitem>
  11319. <para>Support use of <tag>titleabbrev</tag> in running
  11320. headers and footers.
  11321. </para>
  11322. </listitem>
  11323. <listitem>
  11324. <para>Added (experimental) <parameter>xref.with.number.and.title</parameter>
  11325. parameter to enable number/title cross references even when the
  11326. default would
  11327. be just the number.
  11328. </para>
  11329. </listitem>
  11330. <listitem>
  11331. <para>Generate <tag>part</tag> ToCs if they're requested.
  11332. </para>
  11333. </listitem>
  11334. <listitem>
  11335. <para>Use proportional-column-width() in header/footer tables.
  11336. </para>
  11337. </listitem>
  11338. <listitem>
  11339. <para>Handle alignment correctly when <tag>screenshot</tag>
  11340. wraps a graphic in a <tag>figure</tag>.
  11341. </para>
  11342. </listitem>
  11343. <listitem>
  11344. <para>Format <tag>chapter</tag> and <tag>appendix</tag>
  11345. cross references consistently.
  11346. </para>
  11347. </listitem>
  11348. <listitem>
  11349. <para>Attempt to support tables with multiple <tag>tgroup</tag>s
  11350. in FO.
  11351. </para>
  11352. </listitem>
  11353. <listitem>
  11354. <para>Output <tag>fo:table-columns</tag> in
  11355. <tag>simplelist</tag> tables.
  11356. </para>
  11357. </listitem>
  11358. <listitem>
  11359. <para>Use <filename>titlepage.templates.xml</filename> for
  11360. <tag>indexdiv</tag> and <tag>glossdiv</tag> formatting.
  11361. </para>
  11362. </listitem>
  11363. <listitem>
  11364. <para>Improve support for new bibliography elements.
  11365. </para>
  11366. </listitem>
  11367. <listitem>
  11368. <para>Added
  11369. <parameter>footnote.number.format</parameter>,
  11370. <parameter>table.footnote.number.format</parameter>,
  11371. <parameter>footnote.number.symbols</parameter>, and
  11372. <parameter>table.footnote.number.symbols</parameter> for better control of
  11373. footnote markers.
  11374. </para>
  11375. </listitem>
  11376. <listitem>
  11377. <para>Added <tag>glossentry.show.acronyms</tag>.
  11378. </para>
  11379. </listitem>
  11380. <listitem>
  11381. <para>Suppress the draft-mode page masters when
  11382. <parameter>draft-mode</parameter> is <quote>no</quote>.
  11383. </para>
  11384. </listitem>
  11385. <listitem>
  11386. <para>Make blank pages verso not recto. D'Oh!
  11387. </para>
  11388. </listitem>
  11389. <listitem>
  11390. <para>Improved formatting of <tag>ulink</tag> footnotes.
  11391. </para>
  11392. </listitem>
  11393. <listitem>
  11394. <para>Fixed bugs in graphic width/height calculations.
  11395. </para>
  11396. </listitem>
  11397. <listitem>
  11398. <para>Added class attributes to inline elements.
  11399. </para>
  11400. </listitem>
  11401. <listitem>
  11402. <para>Don't add <quote>.html</quote> to the filenames identified
  11403. with the <quote>dbhtml</quote> PI.
  11404. </para>
  11405. </listitem>
  11406. <listitem>
  11407. <para>Don't force a ToC when sections contain <tag>refentry</tag>s.
  11408. </para>
  11409. </listitem>
  11410. <listitem>
  11411. <para>Make section title sizes a function of the
  11412. <parameter>body.master.size</parameter>.
  11413. </para>
  11414. </listitem>
  11415. </itemizedlist>
  11416. </sect1>
  11417. <sect1 xml:id="V1592">
  11418. <title>Release 1.59.2</title>
  11419. <itemizedlist>
  11420. <para>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
  11421. </para>
  11422. <listitem>
  11423. <para>Removed the region-name from the region-body of blank pages. There's
  11424. no reason to give the body of blank pages a unique name and doing so causes
  11425. a mismatch that FOP detects.
  11426. </para>
  11427. </listitem>
  11428. <listitem>
  11429. <para>Output IDs for the first paragraphs in listitems.
  11430. </para>
  11431. </listitem>
  11432. <listitem>
  11433. <para>Fixed some small bugs in the handling of page numbers in double-sided mode.
  11434. </para>
  11435. </listitem>
  11436. <listitem>
  11437. <para>Attempt to prevent duplicated IDs from being produced when
  11438. <tag class="attribute">endterm</tag> on <tag>xref</tag> points
  11439. to something with nested structure.
  11440. </para>
  11441. </listitem>
  11442. <listitem>
  11443. <para>Fix aligment problems in <tag>equation</tag>s.
  11444. </para>
  11445. </listitem>
  11446. <listitem>
  11447. <para>Output the type attribute on unordered lists (UL) in HTML only if
  11448. the css.decoration parameter is true.
  11449. </para>
  11450. </listitem>
  11451. <listitem>
  11452. <para>Calculate the font size in formal.title.properties so that it's 1.2 times
  11453. the base font size, not a fixed "12pt".
  11454. </para>
  11455. </listitem>
  11456. </itemizedlist>
  11457. </sect1>
  11458. <sect1 xml:id="V1591">
  11459. <title>Release 1.59.1</title>
  11460. <itemizedlist>
  11461. <para>The 1.59.1 fixes a few bugs.
  11462. </para>
  11463. <listitem>
  11464. <para>Added Bulgarian localization.
  11465. </para>
  11466. </listitem>
  11467. <listitem>
  11468. <para>Indexing improvements; localize book indexes to books but allow setindex
  11469. to index an entire set.
  11470. </para>
  11471. </listitem>
  11472. <listitem>
  11473. <para>The default value for rowsep and colsep is now "1" as per CALS.
  11474. </para>
  11475. </listitem>
  11476. <listitem>
  11477. <para>Added support for <tag>titleabbrev</tag> (use them for cross
  11478. references).
  11479. </para>
  11480. </listitem>
  11481. <listitem>
  11482. <para>Improvements to <tag>mediaobject</tag> for selecting print vs. online
  11483. images.
  11484. </para>
  11485. </listitem>
  11486. <listitem>
  11487. <para>Added seperate property sets for <tag>figure</tag>s,
  11488. <tag>example</tag>s, <tag>equation</tag>s, <tag>tables</tag>s,
  11489. and <tag>procedure</tag>s.
  11490. </para>
  11491. </listitem>
  11492. <listitem>
  11493. <para>Make <tag>lineannotation</tag>s italic.
  11494. </para>
  11495. </listitem>
  11496. <listitem>
  11497. <para>Support <tag class="attribute">xrefstyle</tag> attribute.
  11498. </para>
  11499. </listitem>
  11500. <listitem>
  11501. <para>Make <tag class="attribute">endterm</tag> on
  11502. <tag>xref</tag> higher priority than
  11503. <tag class="attribute">xreflabel</tag> target.
  11504. </para>
  11505. </listitem>
  11506. <listitem>
  11507. <para>Glossary formatting improvements.
  11508. </para>
  11509. </listitem>
  11510. </itemizedlist>
  11511. </sect1>
  11512. <sect1 xml:id="V1580">
  11513. <title>Release 1.58.0</title>
  11514. <itemizedlist>
  11515. <para>The 1.58.0 adds some initial support for extensions in xsltproc, adds
  11516. a few features, and fixes bugs.
  11517. </para>
  11518. <listitem>
  11519. <para>This release contains the first attempt at extension support for xsltproc.
  11520. The only extension available to date is the one that adjusts table column widths.
  11521. Run <filename>extensions/xsltproc/python/xslt.py</filename>.
  11522. </para>
  11523. </listitem>
  11524. <listitem>
  11525. <para>Fixed bugs in calculation of adjusted column widths to correct for rounding
  11526. errors.
  11527. </para>
  11528. </listitem>
  11529. <listitem>
  11530. <para>Support nested <tag>refsection</tag> elements correctly.
  11531. </para>
  11532. </listitem>
  11533. <listitem>
  11534. <para>Reworked <literal>gentext.template</literal> to take context into consideration.
  11535. The name of elements in localization files is now an xpath-like context list, not
  11536. just a simple name.
  11537. </para>
  11538. </listitem>
  11539. <listitem>
  11540. <para>Made some improvements to bibliography formatting.
  11541. </para>
  11542. </listitem>
  11543. <listitem>
  11544. <para>Improved graphical formatting of admonitions.
  11545. </para>
  11546. </listitem>
  11547. <listitem>
  11548. <para>Added support for <tag>entrytbl</tag>.
  11549. </para>
  11550. </listitem>
  11551. <listitem>
  11552. <para>Support spanning index terms.
  11553. </para>
  11554. </listitem>
  11555. <listitem>
  11556. <para>Support <tag>bibliosource</tag>.
  11557. </para>
  11558. </listitem>
  11559. </itemizedlist>
  11560. </sect1>
  11561. <sect1 xml:id="V1570">
  11562. <title>Release 1.57.0</title>
  11563. <itemizedlist>
  11564. <listitem>
  11565. <para>The 1.57.0 release wasn't documented here. Oops.
  11566. </para>
  11567. </listitem>
  11568. </itemizedlist>
  11569. </sect1>
  11570. <sect1 xml:id="V1560">
  11571. <title>Release 1.56.0</title>
  11572. <itemizedlist>
  11573. <para>The 1.56.0 release fixes bugs.
  11574. </para>
  11575. <listitem>
  11576. <para>Reworked chunking. <emphasis>This will break all existing customizations
  11577. layers that change the chunking algorithm.</emphasis> If you're customizing chunking,
  11578. look at the new <quote>content</quote> parameter that's passed to
  11579. <literal>process-chunk-element</literal> and friends.
  11580. </para>
  11581. </listitem>
  11582. <listitem>
  11583. <para>Support continued and inherited numeration in <tag>orderedlist</tag>
  11584. formatting for FOs.
  11585. </para>
  11586. </listitem>
  11587. <listitem>
  11588. <para>Added Thai localization.
  11589. </para>
  11590. </listitem>
  11591. <listitem>
  11592. <para>Tweaked stylesheet documentation stylesheets to link to TDG and
  11593. the parameter references.
  11594. </para>
  11595. </listitem>
  11596. <listitem>
  11597. <para>Allow title on tables of contents ("Table of Contents") to be optional.
  11598. Added new keyword to <parameter>generate.toc</parameter>.
  11599. Support tables of contents on sections.
  11600. </para>
  11601. </listitem>
  11602. <listitem>
  11603. <para>Made separate parameters for table borders and table cell borders:
  11604. <parameter>table.frame.border.color</parameter>,
  11605. <parameter>table.frame.border.style</parameter>,
  11606. <parameter>table.frame.border.thickness</parameter>,
  11607. <parameter>table.cell.border.color</parameter>,
  11608. <parameter>table.cell.border.style</parameter>, and
  11609. <parameter>table.cell.border.thickness</parameter>.
  11610. </para>
  11611. </listitem>
  11612. <listitem>
  11613. <para>Suppress formatting of <quote>endofrange</quote> <tag>indexterm</tag>s.
  11614. This is only half-right. They should generate a range, but I haven't figured out how
  11615. to do that yet.
  11616. </para>
  11617. </listitem>
  11618. <listitem>
  11619. <para>Support <tag>revdescription</tag>. (Bug #582192)
  11620. </para>
  11621. </listitem>
  11622. <listitem>
  11623. <para>Added <parameter>default.float.class</parameter> and fixed figure
  11624. floats. (Bug #497603)
  11625. </para>
  11626. </listitem>
  11627. <listitem>
  11628. <para>Fixed formatting of <tag>sbr</tag> in FOs.
  11629. </para>
  11630. </listitem>
  11631. <listitem>
  11632. <para>Added context to the <quote>missing template</quote> error message.
  11633. </para>
  11634. </listitem>
  11635. <listitem>
  11636. <para>Process <tag>arg</tag> correctly in a <tag>group</tag>.
  11637. (Bug #605150)
  11638. </para>
  11639. </listitem>
  11640. <listitem>
  11641. <para>Removed 'keep-with-next' from <parameter>formal.title.properties</parameter>
  11642. attribute set now that the stylesheets support the option of putting
  11643. such titles below the object. Now the $placement value determines if
  11644. 'keep-with-next' or 'keep-with-previous' is used in the title block.
  11645. </para>
  11646. </listitem>
  11647. <listitem>
  11648. <para>Wrap <quote>url()</quote> around external-destinations when appropriate.
  11649. </para>
  11650. </listitem>
  11651. <listitem>
  11652. <para>Fixed typo in compact list spacing. (Bug #615464)
  11653. </para>
  11654. </listitem>
  11655. <listitem>
  11656. <para>Removed spurious hash in anchor name. (Bug #617717)
  11657. </para>
  11658. </listitem>
  11659. <listitem>
  11660. <para>Address is now displayed verbatim on title pages. (Bug #618600)
  11661. </para>
  11662. </listitem>
  11663. <listitem>
  11664. <para>The <parameter>bridgehead.in.toc</parameter> parameter is now properly
  11665. supported.
  11666. </para>
  11667. </listitem>
  11668. <listitem>
  11669. <para>Improved effectiveness of HTML cleanup by increasing the number
  11670. of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
  11671. </para>
  11672. </listitem>
  11673. <listitem>
  11674. <para>Support table of contents for <tag>appendix</tag> in
  11675. <tag>article</tag>. (Bug #596599)
  11676. </para>
  11677. </listitem>
  11678. <listitem>
  11679. <para>Don't duplicate footnotes in <tag>bibliography</tag>s and
  11680. <tag>glossary</tag>s. (Bug #583282)
  11681. </para>
  11682. </listitem>
  11683. <listitem>
  11684. <para>Added <parameter>default.image.width</parameter>. (Bug #516859)
  11685. </para>
  11686. </listitem>
  11687. <listitem>
  11688. <para>Totally reworked <tag>funcsynopsis</tag> code; it now
  11689. supports a 'tabular' presentation style for 'wide' prototypes; see
  11690. <parameter>funcsynopsis.tabular.threshold</parameter>. (HTML only
  11691. right now, I think, FO support, uh, real soon now.)
  11692. </para>
  11693. </listitem>
  11694. <listitem>
  11695. <para>Reworked support for difference marking; toned down the colors a bit
  11696. and added a <quote>system.head.content</quote> template so that the diff CSS
  11697. wasn't overriding <quote>user.head.content</quote>. (Bug #610660)
  11698. </para>
  11699. </listitem>
  11700. <listitem>
  11701. <para>Added call to the <quote>*.head.content</quote> elements when writing
  11702. out long description chunks.
  11703. </para>
  11704. </listitem>
  11705. <listitem>
  11706. <para>Make sure <tag>legalnotice</tag> link is correct even when
  11707. chunking to a different <parameter>base.dir</parameter>.
  11708. </para>
  11709. </listitem>
  11710. <listitem>
  11711. <para>Use CSS to set viewport characteristics if
  11712. <parameter>css.decoration</parameter> is non-zero, use div instead of p for making
  11713. graphic a block element; make figure <tag>title</tag>s the
  11714. default alt
  11715. text for images in a <tag>figure</tag>.</para>
  11716. </listitem>
  11717. <listitem>
  11718. <para>Added space-after to <parameter>list.block.spacing</parameter>.
  11719. </para>
  11720. </listitem>
  11721. <listitem>
  11722. <para>Reworked section.level template to give <quote>correct</quote> answer
  11723. instead of being off by one.
  11724. </para>
  11725. </listitem>
  11726. <listitem>
  11727. <para>When processing tables, use the <tag class="attribute">tabstyle</tag>
  11728. attribute as the division class.
  11729. </para>
  11730. </listitem>
  11731. <listitem>
  11732. <para>Fixed bug in <filename>html2xhtml.xsl</filename> that was causing the
  11733. XHTML chunker to output HTML instead of XHTML.
  11734. </para>
  11735. </listitem>
  11736. </itemizedlist>
  11737. </sect1>
  11738. <sect1 xml:id="VOlder">
  11739. <title>Older releases</title>
  11740. <para>To view the release notes for older releases, see <uri xlink:href="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml">http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml</uri>. Be
  11741. aware that there were no release notes for releases prior to the
  11742. 1.50.0 release.</para>
  11743. </sect1>
  11744. <sect1 xml:id="dot0">
  11745. <title>About dot-zero releases</title>
  11746. <para>DocBook Project &#x201C;dot zero&#x201D; releases should be
  11747. considered <emphasis>experimental</emphasis> and are always
  11748. followed by stable &#x201C;dot one plus&#x201D; releases, usually within
  11749. two or three weeks. Please help to ensure the stability of
  11750. &#x201C;dot one plus&#x201D; releases by carefully testing each
  11751. &#x201C;dot zero&#x201D; release and reporting back about any
  11752. problems you find. </para>
  11753. <para>It is not recommended that you use a &#x201C;dot zero&#x201D;
  11754. release in a production system. Instead, you should wait for
  11755. the &#x201C;dot one&#x201D; or greater versions.</para>
  11756. </sect1>
  11757. </article>