From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 23504 invoked by alias); 10 Dec 2009 16:02:30 -0000 Received: (qmail 20432 invoked by uid 48); 10 Dec 2009 16:02:14 -0000 Date: Thu, 10 Dec 2009 16:02:00 -0000 From: "dmalcolm at redhat dot com" To: systemtap@sources.redhat.com Message-ID: <20091210160213.11077.dmalcolm@redhat.com> Reply-To: sourceware-bugzilla@sourceware.org Subject: [Bug documentation/11077] New: URLs in the HTML documentation are not meaningful X-Bugzilla-Reason: AssignedTo Mailing-List: contact systemtap-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: systemtap-owner@sourceware.org X-SW-Source: 2009-q4/txt/msg00876.txt.bz2 Looking up information in the online documentation, I see URL fragments like this: http://sourceware.org/systemtap/langref/node6.html#SECTION000612000000000000000 These URLs are not human-readable, and are fragile; they will change when new content is added above them in the source file. The above URL would be better as something like: http://sourceware.org/systemtap/langref/ProbePoints.html#PointerTypecasting This would be human-readable, more robust in the face of editing, and be more likely to show up in search engines. It looks like you're using DocBook to generate these docs. I think you can fix this by adding "id" attributes to the relevant
tags. -- Summary: URLs in the HTML documentation are not meaningful Product: systemtap Version: unspecified Status: NEW Severity: normal Priority: P2 Component: documentation AssignedTo: systemtap at sources dot redhat dot com ReportedBy: dmalcolm at redhat dot com http://sourceware.org/bugzilla/show_bug.cgi?id=11077 ------- You are receiving this mail because: ------- You are the assignee for the bug, or are watching the assignee.