Maintain docs for "Internet Keywords"


17 years ago
5 years ago


(Reporter: Tobias Burnus, Assigned: benc)


Firefox Tracking Flags

(Not tracked)




(1 attachment)



17 years ago
Hi, clicking on "more information" in the preferences of internet keywords
should open a window (loaded from the harddisk not from the net, as it is done
for cookies and internetsecurity) which explains how to use them (go keyword
syntax as I learned from bug 58141).
Presently is opened which isn't really a help.
(I dislike (a) that there is no explanation and (b) that it accesses the net.)
The current "explanation" is definitely unenlightening.  status -> new
Ever confirmed: true
QA Contact: sairuh → claudius
Clicking on "More Information" makes it pretty hard to find the preferences
window after reading the page - the browser window hides the preferences window.
Futhermore, after closing the window you can see the preferences window with a
window in the back - the one you just closed???

And when choosing Edit/Preferences in the "explanation window" again, the
preferences don't appear, and you can't do anything w/ Mozilla, at least not
with the current window.

Comment 3

17 years ago
Triaging the Most doomed (which Happens to Ben right now :)

Adding polish keyword.
Severity: normal → trivial
Keywords: polish

Comment 4

17 years ago
-> UI Design for wording/best help
Assignee: ben → mpt
Component: XP Apps: GUI Features → User Interface Design
QA Contact: claudius → zach

Comment 5

17 years ago
Internet Keywords are Netscape, not Mozilla, right? (And if not, why not?) So 
what does it have to do with me?

See also bug 52372, which (IMO) hasn't been properly fixed yet.

Comment 6

17 years ago
not exactly. Keywords are built-in to the browser. Netscape makes more open use of them by
including a keyword dropdown next to the url bar  - but that doesn't mean they don't still work
just fine. In the NS build, clicking 'more info' opens up a new browser window connected to a page
that amazingly enough, contains more information.

So, if the summary of this bug is the true goal - then your more info is available. You could
point to the page(I guess) or host a similar version, or do this like all the other prefs and simply
load a static page that is shipped with the browser.

Comment 7

17 years ago
Well, I don't see why:
*   opening a browser window, in which the menus appear enabled but cannot be
    clicked, can possibly be acceptable (no matter what page the browser
*   a feature should exist in a non-commercial build of Mozilla which exists
    solely to take you to pages on (blocks bug 14532);
*   a feature should exist in Mozilla at all where typing `quote Shakespeare'
    in the address field will result in something different from a Web search
    for Shakespeare quotes.

So I think Internet Keywords should go away. But while they're in Mozilla, the 
proper place to provide help for them is in the online help, not in a browser 
window. --> Help
Assignee: mpt → verah
Component: User Interface Design → Help
QA Contact: zach → tpreston

Comment 8

17 years ago
--> Ian
Assignee: verah → oeschger

Comment 9

16 years ago
Setting to Moz 1.0.
Target Milestone: --- → mozilla1.0


16 years ago
Target Milestone: mozilla1.0 → mozilla1.0.1

Comment 10

16 years ago
The mozilla default was changed to:

in another bug, where I asked to change the default to "off" and then provide
better documentation.

I'm currently re-writing the documentation for that page, because the initial
write up was not as oriented to the mozilla community as I would have liked.

So, I guess you could legitimately assign this bug to me.

I've put my latest draft in the URL field.

Comment 11

15 years ago
-> docs. This is a web page, not in-line documentation.
Component: Help → User
Product: Browser → Documentation
Target Milestone: mozilla1.0.1 → Future
Version: Trunk → unspecified

Comment 12

15 years ago
I've re-written the draft in the URL, and checked it into

Once it appears, I'm going to resolve this bug.

I am considering creating a "feedback:" bug for that document, and link the
document to the feedback bug, but nobody seems to use that on my other pages.

If you have immediate feedback, please let me know here.
Assignee: oeschger → benc

Comment 13

15 years ago
This is done.

Terri, if you are not the QA of this feature, please re-assign to the component

Also, there are problems with where the links should go in the doc structure,
see bug 186031.
Last Resolved: 15 years ago
Resolution: --- → FIXED


15 years ago

Comment 14

15 years ago

Comment 15

14 years ago
Updated docs:

Removed or updated Netscape, Phoenix references. Changed examples b/c we now use
google. Explained changes to google, and how it will work.
Summary: Internet keywords should be better explained → Write docs for "Internet Keywords"

Comment 16

14 years ago
Need to add a "IK != search" paragraph, and a "IK server examples" section would
be nice too.

Comment 17

13 years ago
Created attachment 156768 [details] [diff] [review]
Suggestions about grammar, usage, and the use of the H2 tag

I have attached a patch with my nitpicks about grammar, usage, and HTML.  Note
that I am not a developer, and so I do not know of any style guidelines or
things like that I should be following.  I simply wish to be more

Comment 18

13 years ago
Sorry for the spam-like double post.

I have done a little more research, and I found two pages with
documentation already written that are as readable as I would
like.  One is the basis of the second part of the end-user docs
we already have:

However, it has a coherence that was lost with revision (probably
to avoid alienating end-users who are not developers, as well as
to add mention of the change to Google's I'm Feeling Lucky as a
keyword server).  Another of its features lost in the mists of
time is its link to the second well-written page I mentioned:

Netscape's documentation of Internet Keywords is very well made,
useful for end-users, and useful for developers.  As it is not
under the control of, to use it in the current Mozilla
doc's stead would require getting AOL to release their copyright
on it to (or FDL it, etc).  I don't know how difficult
that would be.

I suggest that
be replaced with a short page containing:
 * a paragraph explaining Internet Keywords' default behavior in Firefox
    (Internet Keywords allows you to access a page without knowing its
     address by sending unresolved requests in the location bar to
     Google's I'm Feeling Lucky service.)
 * a link to Netscape's page for novice users, and information on Netscape's
keyword server
 * a link to a local copy of's page at for
experienced users, or those wondering about internals

Comment 19

13 years ago
boy I'm in trouble, because, I wrote the mozilla page to replace the other two

I will look at the suggestions you made. The document was targeted to an
audience that wanted more explaination than the usual online help, but might
need some updating now that we have Moz + FF.
Resolution: FIXED → ---

Comment 20

13 years ago
I'm doing my annual doc review... does this doc need to be re-written to be
FF-centric? Or do we need a separate doc for FF?
QA Contact: tpreston → daniel.bugmail
Summary: Write docs for "Internet Keywords" → Maintain docs for "Internet Keywords"

Comment 21

13 years ago
Should we add more comments about other keyword servers, like Bug 258838?
Keywords: polish

Comment 22

13 years ago
> NOTE: The change was made in "all.js", which means each installed version
> carries its own default value. Unless you changed keyword.url in your profile,
> the newer versions will use Google.

can be reduced to "The change should take effect on upgrade unless you have
customized the server setting"

The page should link to
Component: Help Viewer →
Product: Documentation →
Target Milestone: Future → ---
Version: unspecified → other

Comment 23

13 years ago
Jonathan, could perhaps update the patch and request review from the owner of
the document or someone else capable of reviewing the document?
QA Contact: danielwang → www-mozilla-org

Comment 24

10 years ago
I re-wrote a lot of the context of this document to reflect the state-of-the-world, (aka Firefox 2.0). I'm mostly interested in working on fixing/improving core features, so I will not be contributing FF-only docs. Someone is welcome to make a shorter version, and I would be happy to review it and help out.

Checking in mozilla-org/html/docs/end-user/internet-keywords.html;
/www/mozilla-org/html/docs/end-user/internet-keywords.html,v  <--  internet-keywords.html
new revision: 1.14; previous revision: 1.13

- did not use, b/c it seems to be gone.
- sometime in the next year, will probably go away too (my domain).

Comment 25

10 years ago

I tried to follow your patch, but then CVS doctor died on me.

Your html suggestions should be followed in my change above (to the best of my ability).

I'm going to do another edit to pick up the glaring grammatical errors, but it would be nice if you reviewed the new document. Rather than a patch, I suggest making numbered suggestions in a bug comment, b/c I can check them off one-by-one.

Comment 26

10 years ago
Last Resolved: 15 years ago10 years ago
Resolution: --- → FIXED
Product: → Websites
Component: → General
Product: Websites →
You need to log in before you can comment on or make changes to this bug.