View Issue Details

IDProjectCategoryView StatusLast Update
00019481003.1(2024)/Issue8System Interfacespublic2025-10-09 15:59
Reporterdag-erling Assigned To 
PrioritynormalSeverityEditorialTypeEnhancement Request
Status ResolvedResolutionAccepted 
NameDag-Erling Smørgrav
Organization
User Reference
SectionVol 2 Ch 3
Page Number658, 1874
Line Number23089, 61850-61852
Interp Status---
Final Accepted Text
Summary0001948: indexing / xref issues regarding realpath and basename
DescriptionI would expect a keyword search for the word “realpath” in the HTML version to produce both XCU `realpath` and XSH `realpath()`, but it produces only XCU `realpath`. This in turn references XSH `realpath()` in its SEE ALSO section. However, the SEE ALSO section of XSH `realpath()` function does not reference XCU `realpath`.

Compare with e.g. XCU `basename` / XSH `basename()` which are both discoverable through a keyword search for “basename” and both reference each other. However, XSH `basename()` also references XSH `dirname()` but not XCU `dirname`, while XSH `dirname()` references both XSH `basename()` and XCU `basename` in addition to XCU `dirname`.

The PDF version's index correctly lists both XCU `realpath` and XSH `realpath()`.
Desired ActionFix the keyword search and add missing cross-references:

The SEE ALSO section for XSH `realpath()` should reference XCU `realpath` (lines 61850-61852).

The SEE ALSO section for XSH `basename()` should reference XCU `dirname` (line 23089).
Tagstc1-2024
Attached Files

Activities

ajosey

2025-10-09 15:55

manager   bugnote:0007287

Last edited: 2025-10-09 15:55

The HTML search issue was caused by the search script sorting and having two keys identical, in which case the second one overwrote the first. The keys were made unique for realpath/basename and dirname by adding function or text to the returned value.

Issue History

Date Modified Username Field Change
2025-09-18 15:23 dag-erling New Issue
2025-09-18 15:23 dag-erling File Added: Screenshot at 2025-09-18 17-21-29.png
2025-10-09 15:55 ajosey Note Added: 0007287
2025-10-09 15:55 ajosey Note Edited: 0007287
2025-10-09 15:59 geoffclare Status New => Resolved
2025-10-09 15:59 geoffclare Resolution Open => Accepted
2025-10-09 15:59 geoffclare Interp Status => ---
2025-10-09 15:59 geoffclare Tag Attached: tc1-2024