qupload和qupload2的file-list参数是否是无效的

[bakabird]

虽然qupload和qupload2的文档中都介绍了file-list参数的设计接口。但如何使用file-list未进行说明，尝试以如下格式进行遇到错误。

/root/file1.txt
/root/file2.txt
/root/file3.txt

[xushiwei]

看如何改善才能让用户自服务

[Mei-Zhao]

感谢您的反馈，file_list的作用是当您指定了src_dir同步目录，但是只想目录下指定文件做上传时指定文件列表的作用，qupload和qupload2使用文档对这个功能的使用不够明确详细，我们会补充文档，增加help使用手册说明，内部跟踪issue编号KODO-10278, KODO-10284

[xushiwei]

@Mei-Zhao 软件自身的自服务也很有价值（更有价值）。比如：qupload help 说明足够完整么，是否可以让文档出现在用户更近的地方。实在不行，qupload help 中是否能够出现 doc 的 link，让用户可以点一下就过去？这样才是自服务的软件。

[corxit]

1. file-list 这个参数的正确写法是 file_list
2.file_list 接受的参数是 [记录文件列表的文件] 的路径，而不是 [文件列表内容] 。题主应该是直接使用了内容。所以不生效。

[xushiwei]

既然有此误用，可考虑 unmarshal 失败时，检查传入的 file_list 是否存在误用的情况，如果误用，提示正确用法应该怎样。这样 qshell 就具备了自服务的能力，减少对文档的依赖。@Mei-Zhao