00136: include directive don't work with partial includes

Summary: include directive don't work with partial includes
Created: 2004-11-02 09:47
Status: Closed - fixed
Category: Documentation Bug
From: MarcioRPS
Assigned:
Priority: 2
Version: 2.0devel16
OS: Linux Apache 1.3 PHP?

Description: cheshyrekatt: per new documentation fix, new format of (:include PageName lines=5..11:) works. I'd recommend replacing old markup with new on first edit if possible.


cheshyrekatt: doesn't function as it did in ver 1. The partial include is what is being described here. Yes, as written, the lines=## portion will grab the first ## lines of the file, but, as I do in my site, I grab at line 5 and go to 11 for example (:include PageName#5#11:). For me, it is failing with beta 6 code.


foolswisdom: seems to function as documented in pmwiki-2.0.devel26 , I recommend this PITS/00136 be closed .


I tried it both with my site (www.yuy.com.br) and in the sandbox here. The (:include:) directive only works for basic inclusion, it fails to both include parts of pages as described in the documentation. At my site I also have problems with inserting pages from different groups, but it seems solved here at pmwiki.org.

NOTE: then I realized it WAS working in the Main.SideBar, no matter I couldn't make it work for me, then I checked te sidebar to discover it uses a different sintax, which seems to work differently: (:include SomePage lines=10:) . It also works at my site. So probably it is all a problem in the documentation... Well, I was just trying to help, really... =(

a demonstration. between the horizontal rules, I put (:include Guidelines#1#5 :) , but the whole file gets included. Though at first I thought I would never use this function, but nevertheless I realized the RecentChanges#1#10 trick was neat and had problems...


  • if you have an issue to be addressed, check the lists of active and awaiting feedback issues to see if there is already made a PITS entry for it.
    • also check the complete list in case the issue has been reported and resolved previously
  • if a similar issues does exist you can
    • edit the PITS entry to add more details, opinions
    • add your vote on the issue's priority and popularity, issues with higher priority and more votes votes tend to get greater attention. (See below.)
  • if no similar issue has yet been registered, click on the new issue link and fill out the form to add the new issue to the tracking system
    • ensure the title is suggestive enough that others can understand the issue (and add their votes to the priority)
    • for bug reports make sure the description includes enough details that someone can observe or duplicate the bug so a fix can be found
    • see also How To Get Assistance
  • the description text is just wiki text, so it's okay to include links to other pages and sites to further demonstrate or explain the issue.

The status of each issue is typically given as one of:

active
new issues and issues still under consideration
confirmed
the issue has been confirmed to exist but still needs a fix
waiting
awaiting feedback: more information is needed before the issue can be addressed
ToDo
Pm has it on his "to do" list of things to be addressed
inactive
PITS discussions that have been inactive for 365 days or more. If some issues were not resolved in recent PmWiki releases, please edit or vote for the corresponding issue. The entry will automatically reappear in the Active issues lists.
suspended
items that are open for consideration, but aren't being immediately addressed either for technical reasons or because with PmWiki Philosophy? #3 there's not enough interest/priority to make the issue "ripe". Adding priority votes or details to these items may help to move them back to open status.
closed
issues that are considered resolved (fixed, added or declined). If you feel some listed issue requires some action, you can either reopen it, or create a new one.

A note about how Pm views the priorities:

"The priorities are primarily advisory, but they do carry a lot of weight with me, especially if there are a large number of votes. But when setting out to work on something I examine not only an issue's priority but also its difficulty and the impacts it might have on other features in the overall systems. So, issues that are listed low or medium priority but otherwise easily addressed may get taken care of quickly, while high priority issues that require lots of planning and effort may take longer to be addressed.
But it's also worth pointing out that if an issue is especially important to you and you want to get beyond simple appeals to my reason, it is possible to use economic and market incentives to adjust my perceptions of issues' priorities :-). (See SendPmMoney). " --Pm