= Description =

The "Free Parent Link" Syntax 

does no longer work as it used to in 1.1. And more interestingly, the "Free Sibling Link" does not work as well.

== Steps to reproduce ==
## Describe the steps needed to reproduce the bug. If we can't reproduce it, we  probably can't fix it.
 1. go to e.g. http://moinmaster.wikiwikiweb.de/HelpOnEditing/SubPages and check the last link

== Example ==

{{{
 * [:../:free parent link]
 * [:../SubPages:free sibling link]
}}} 

Renders as:
 * [[../|free parent link]]
 * [[../SubPages|free sibling link]]


== Details ==
This Wiki or Moin Master.

== Workaround ==
## How to deal with the bug until it is fixed


= Discussion =

This syntax was experimental and was never official documented syntax. The official syntax for free links is
{{{
 * ["free link"]
 * ["../sibling link"]
 * ["../"]
}}}

 * [[free link]]
 * [[../sibling link]]
 * [[../]]

If it worked in 1.1, we should try to make it work again in 1.3. In 1.4 we should redesign the syntax, specifically the link syntax which is a big mess. -- NirSoffer <<DateTime(2005-02-17T21:21:09Z)>>
 It was very official: it was in the main documentation.
  No it was not, it was and still is in HelpMiscellaneous/ExperimentalFeatures. Note the comment on that page:
   '''This page describes features that are not completed yet or need pratical testing before they're added to the standard feature set. They might disappear or be changed subtantially!'''

   It seems that this feature just disappeared :).
    Yeah, unsupported but official `:-p`
   
Note that someone added this link type to HelpOnLinking in rev 15 on 2004-10-19 15:03:49: http://moinmoin.wikiwikiweb.de/HelpOnLinking?action=diff&rev2=15&rev1=14
 I think we should remove this from the official page, as this syntax is ugly and we  (most developers) want to remove it anyway.

 Sorry, but I may have created a misunderstanding here by using the description "free sibling link", I meant "extended link syntax for siblings".

 So what I was looking for was:
 {{{
  * [:../:text for the link]
  * [:../SubPages:text for the link]
 }}} 
 
 which should go to Pages {{{../}}} and {{{../SubPages}}} while displaying "text for the link".
 The proposed
 {{{
  * ["../sibling link"]
 }}}
 would, written as
 {{{
  * ["../SubPages text for the link"]
 }}} 
 look for a page {{{SubPages_text_for_the_link}}}
 which is not what I want.
 I would have expected a syntax like
 {{{
  * [wiki:../SubPages text for the link] or
  * [wiki:Self:../SubPages text for the link]
 }}}
 but this did not work, so I was happy to find {{{:../: parent}}} in the official help and discovered that {{{[:../SubPages:text for the link]}}} did what I wanted in 1.1. I admit that this was somewhat undocumented. Sorry for the confusion. -- RobertSeeger <<DateTime(2005-02-18T11:23:12Z)>> 
----

Why do we have two ways for free links?

{{{
 * ["free link"]
 * [:free link]

 * [:free link:text for free link]
}}}

We can do it by extending {{{[" "]}}} syntax.

{{{
 * ["free link"]
 * ["free link" text for free link]
}}}

 No, that doesn't work, then you can't link to a page containing a quote [[like"this]]. -- JohannesBerg <<DateTime(2005-03-07T10:40:53Z)>>

  Pages with quotation marks suffer from a design issue in the search engine as well - you cannot easily search for them.

Then how about to treat {{{[" "]}}} and {{{[: :]}}} in a similar way?
{{{
 * [:free link:]  (instead of [:free link])
 * [:free link: text for free link]
}}}
We can place any meta character (maybe configurable) here. for example, {{{[' ']}}}, {{{[! !]}}}, ...

----

I think this is a bug. Fixing subpage linking requires the Self: formatter of text_html.interwikilink to recognize the subpage marker ('/'). Fixing this is quite easy, just add the check and add the page_name to the url. [[attachment:fix-subpage-Self.diff]]

-- OliverGraf <<DateTime(2005-03-07T13:29:31Z)>>

Fixing parent links ('../') is equally easy. It needs to be checked, too. But I must commit that we really need to rewrite this in 1.4. But for 1.3 this should be fixed. [[attachment:fix-subpage-Self2.diff]]

-- OliverGraf <<DateTime(2005-03-07T13:39:33Z)>>

This patch even allow links like: `[wiki:Self:../SubPage Link Name]` -- OliverGraf <<DateTime(2005-03-07T13:59:12Z)>>

 Neat, thanks. I hope this goes into the official branch. -- JohannesBerg <<DateTime(2005-03-07T14:09:41Z)>>

 
 Great, thanks, this fixes my original problem. I was even able to apply the basic idea of the patch to my old 1.1. implementation in a couple of minutes (here it has to be put in wiki.py, if anybody needs details, drop me a line), so I got rid of the flimsy "officially unofficial" syntax at all. -- RobertSeeger <<DateTime(2005-03-07T15:55:38Z)>>

= Plan =
## This part is for Moin``Moin developers:

 * Priority: Medium
 * Assigned to: OliverGraf
 * Status: fixed in moin--main--1.3--patch-653

----

## When the bug is fixed, replace the category to Category MoinMoinBugFixed
## If this is not a bug, replace with Category MoinMoinNoBug
CategoryMoinMoinBugFixed [[CategoryRelease1.3.4]]