You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jena.apache.org by "Andy Seaborne (JIRA)" <ji...@apache.org> on 2016/01/09 00:07:39 UTC

[jira] [Commented] (JENA-1114) sparql tool help and documentation should be more specific about --data and --query formating parameters

    [ https://issues.apache.org/jira/browse/JENA-1114?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15090144#comment-15090144 ] 

Andy Seaborne commented on JENA-1114:
-------------------------------------

Could you provide the command you are running and the complete exception?

Do you have a description of the full range of characters that cause problems?  Any other than \ ?

There might be better ways than to merely document it.

(the code in this area has changed a lot since 2012).

> sparql tool help and documentation should be more specific about --data and --query formating parameters
> --------------------------------------------------------------------------------------------------------
>
>                 Key: JENA-1114
>                 URL: https://issues.apache.org/jira/browse/JENA-1114
>             Project: Apache Jena
>          Issue Type: Improvement
>          Components: Cmd line tools, Documentation
>    Affects Versions: Jena 3.0.1
>         Environment: Windows 7
>            Reporter: Ramiro Pereira de Magalhães
>              Labels: documentation
>
> In Windows, the sparql tool's options {{\-\-data}} and {{\-\-query}} must be formated as an URI, or it throws a "Code: 4/UNWISE_CHARACTER in PATH" exception. It took me quite some time to notice that, and probably I would have lost much less time figuring this out if the {{\-\-help}} was explicit about this. The same also applies to the [documentation|https://jena.apache.org/documentation/query/cmds.html]. It seems this confusion happens with [other users too|http://mail-archives.apache.org/mod_mbox/jena-users/201209.mbox/%3C504E4D07.6080803@apache.org%3E].
> Therefore, I suggest that both the command line help and the documentation be updated to be a more specific about this requirement.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)